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Features 

One of the most versatile text editors ever written, ATE can edit any 
kind of text from assembly language to "English" language. 

ATE is completely programmable. You can create your own high-level 
editing commands (or "edit macros"). Repetitious editing operations 
or time consuming tape references can be run automatically. 

The assembler can handle programs larger than memory, can produce 
object code listings in any base you want (hex or octal or decimal or 
whatever), and allows you to edit the object code easily even without 
an object code listing. 

ATE fits into 4K of memory and runs in 8K. More memory can easily be 
utilized since everything (the symbol table, the source file area, etc.,) 
is moveable. 
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Introduction 

For the reader who enjoys learning a new language by total 
immersion, here is an introduction to the text addressing 
capabilities of ATE. Skip this part if you want — detailed 
explanations follow. 



I CANNOT FIND MY WAY. THERE IS NO STAR 

IN ALL THE SHROUDED HEAVENS ANYWHERE. 

"(THERE).. 

THERE IS NO STAR 

IN ALL THE SHROUDED HEAVENS ANYWHERE. 

"..(DED) 

I CANNOT FIND MY WAY. THERE IS NO STAR 

IN ALL THE SHROUDED 

"(TH)..(H) 
THERE IS NO STAR 
IN ALL TH 
"(TH)..(H)..(0) 
THERE IS NO STAR 
IN ALL THE SHRO 
"(TH)..(0) 
THERE IS NO 

"(IN). .(ED) 

IND MY WAY. THERE IS NO STAR 

IN ALL THE SHROUDED 

"(IN )..(ED) 

IN ALL THE SHROUDED 



"(IN )..(ED) 

IN ALL THE SHROUDED 

"/(TH)..(0) 

THE SHRO 

"/..(HE) 

THE 

"(IN )..(ED)/(TH)..(0)/..(HE) 

THE 

"..(HE) 

I CANNOT FIND MY WAY. THE 

"..2(HE) 

I CANNOT FIND MY WAY. THERE IS NO STAR 

IN ALL THE 

"..3( ) 

I CANNOT FIND 

"2( )..3( ) 

FIND MY WAY. 
"-1( ).. 

ANYWHERE. 
"-2( ).. 

HEAVENS ANYWHERE. 

"..^ 

I CANNOT FIND MY WAY. THERE IS NO STAR 
"^..-«- 

IN ALL THE SHROUDED HEAVENS ANYWHERE. 
"(HEAVENS)* 

IN ALL THE SHROUDED HEAVENS ANYWHERE. 

IN ALL THE SHROUDED HEAVENS ANYWHERE. 



"(A)@@(N) 

AVEN 

"( )@@@( ) 

ALL 
"2( )@@@( ) 

THE 
"2( )...() 

FIND 
"15@ 
M 

"..15@ 

I CANNOT FIND M 
"80@ 
? 

"(.)..(.) 

. THERE IS NO STAR 

IN ALL THE SHROUDED HEAVENS ANYWHERE 

"(.)+2. .(.)-! 

THERE IS NO STAR 

IN ALL THE SHROUDED HEAVENS ANYWHERE 

"(HEAVEN)+1 

EAVENS 



"(C). .( 


:d) 


CANNOT 


FIND 


"<..> 




CANNOT 


FIND 


fi 




CANNOT 


FIND 


!'< 




C 





"(C). .(D) 

CANNOT FIND 

"> 

D 
ti 

D 

"(C). .(D) 

CANNOT FIND 

"<+2..>-2 

NNOT Fl 

"(C)..(D)/<+3, 

NOT FIND 

">-2..>+3 

IND MY 



ATE Text Editor 



Design Phi losophy 

A text editor should be: 

(a) easy to learn 

(b) easy to use 

(c) versatile enough to edit any kind of text. 

Most editors available today fail at least one of the above tests, 
For example, the most common kind of editor (from a hobbyist's point of 
view) is probably the simple line editor present in all BASICs and in 
most assembly language systems. This is just dandy as far as (a) and 
(b) above are concerned, as long as you limit your text to relatively 
small computer programs. But large programs are difficult and time- 
co'nsuming to edit this way. And trying to edit non-1 Ine-oriented text 
(such as this) is ridiculous. 

At another extreme are well known editors (supported on large 
computer systems) such as QED and its descendents. They are relatively 
easy to use — once you learn how. But to the non- initiate, they appear 
as such an ad-hocery of special conventions that few take the time to 
learn to use them efficiently. And even these editors usually leave 
something to be desired as far as (c) goes. 

ATE is an attempt to achieve (a), (b), and (c) in one editor, 
(a), by syntactical logic and consistency more typical of a programming 
language than an editor; (b), by keeping verbosity to an absolute 
minimum and allowing Immediate as well as programmed execution of all 
functions; and (c), by Imposing almost no restrictions on the contents 
of a file and providing a very powerful and general text-add resssing 
capabi I ity. 



Basi c editi ng in ATE 

There are really only a few operations involved In actual text editing. 
Consider what is involved in writing a rough draft by hand: 



£KT<ir»»^<? ( •V\5;ev-'r ii^<?') »rv«5.»>J lkjxi< 



WViii^va Tke. lexT. fc K'4 llii\<s — C oltl<J~ii\<i ) — t^ ye Vi y^ /A(ov<Ky ex(5^uiA.<7 



m 



i sut\<^ {^yCl 




to <x v\s.oJ jocdiTToi'V./ Cortr^cJiiA<7 <2.x isTiKq- ri-xT 




The operations illustrated here boil down to 3 basics: entering, killing, 
and moving. (Writing the text in the first place is simply entering 
into an initially empty file. Correcting consists of killing and then 
entering the replacement.) What is needed to make these 3 basic operations 
work effectively is a means of viewing the text and indicating what Is 
to be moved or ki I led, what the destination of the move is, or where an 
entry i s to be made. So we come to 

Text Address i ng 

The examples in this section assume that we already have a text 
file in memory. Initialization of new files and file storage and paging 
will be covered later. Also, ATE commands will be covered in more detail 
later. Most commands require an argument (or value). A I I the commands 
use the same argument format , and this section is devoted to explaining 
that format. 

Suppose the file we are editing contains the following characters: 

WR I T I NG_THE_TEXT. ^« ENTERI NG_NEW_TEXT. 

Here we have used _ for a blank and ^^ for a carriage return. When 

printed out, the file would appear: 

WRITING THE TEXT. 

ENTERING NEW TEXT. 



Suppose we wanted to eliminate the word THE from the fi le. The easiest 

way to do this would be to use the Ki I I function as fol lows: 

K(THE) 



To understand how this works, we need the concept of an i nterva I . Suppose 
we knew that the characters THE occupied memory addresses 2009H, 200AH, 
and 200BH. (H = hex.) Another (seldom used) way to kill THE would be 
to type 
K 2009H.. .200BH 

(THE) and 2009H. . .200BH are both legal arguments to any ATE command, and 
in this case, both would evaluate to the same thing: an i nterva I beginning 
at address 2009H and ending at 200BH. The evaluation process is quite 
different for these two arguments, however. In the second case, ATE would 
not look at the contents of the file at all. It would simply evaluate 
the two numbers (which we could also have given in decimal or octal/ 
straight or split; but more of that later) and pass those two values to 
the Kill routine. The other argument involves a process called matching . 

When ATE encounters an expression such as (THE) in a command argument, 
it searches the file for a string of characters that match the ones 
enclosed in parentheses. If found, the beginning and ending sddress of 
the string become the values of the expression (THE). 

Suppose we want to kill THE> TEXT, and ENTERING, leaving in the file only 

WRITING NEW TEXT. 

Here is one way to do it. 

K (THE)...(ING ) 

Note: Including the blank after the ING keeps the file from being left 
with two blanks between NEW and TEXT. We could just as well have typed 
K ( tHE) . , . ( ING) . Leaving a blank between the command K and its argument 
is optional . 

To evaluate this argument, ATE first finds a match for (THE), and then 
searches forward from there to find a match for (ING )• Then it combines 
these two intervals into a single one extending from the beginning of 
the first to the end of the second. (The ... operator can of course be 
shortened to . ) 



As may now be apparent, all ATE expressions evaluate at an interval. 
For example, 2009H evaluates to an interval beginning and ending at that 
address. 



Suppose we want to ki I I the word TEXT In our f i le. It is apparent that 
we need to be able to distinguish different occurrences of the same string. 
To ki I I the f i rst occurrence of TEXT, we need only type K(TEXT). To ki I I 
the second occurrence and not the first (assuming we are sure that it is 
the second occurrence we are after): K 2(TEXT) 

The argument 2(TEXT) matches the 2 occurrence of TEXT. In general, N( 
matches the N occurrence of the enclosed characters, as long as the 
value of N is positive (less than 32,768). -1( ) will cause the search 
to proceed backwards from the end of the file, matching the first 
occurrence in that direction. -2( ) matches the second occurrence from 
the end, etc. 

But what if we aren't sure how many occurrences of TEXT there are, and we 
don't want to count? 
K (THE)...(ING)/(TEXT) 

(This may look I i ke a lot of typing, but things will get better.) This 
brings us to the concept of a reference string . When ATE begins 
evaluating an argument, it performs any required searches within the 
current f i le . Thus, we say that the current file is the initial 
reference string . But when ATE encounters a /, it takes the interval 
that has been calculated so far and makes |jt the reference string. Any 
subsequent searches will be performed within this new reference string. 

The / operator may be used repeatedly, eg 

K (THE)...(.ING)/(TEXT)/(£) 

This will ki I I the E that is within TEXT that is within THE... ING. 

To ki I I all occurrences of TEXT within the f i le, we use the Repeat command, 
which is explained later. 



Notice that giving a numerical address within an argument does not require 
a search, so the following Is legal: 0. . .4095/(ABC) . This will cause 
a search for the characters ABC within the first 4K block of memory. 
The initial reference string is still the current file, and this 
probably does not contain the interval 0...4095. But since 0...4095 
does not call for a search, there is no problem of not finding this 
interval within the reference string. When the / is encountered, this 
interval becomes the reference string. 

Note : The following example assumes some experience with machine 
language programming. Suppose that the first 4K block of memory does 
not contain an ASCII source file at all, but instead a version of BASIC 
whose I/O routines we are trying to modify. Then we wouldn't want to 
search for ASCII characters such as ABC, but for object code bytes 
such as DB 00 E6 (hex). (This is the object code for IN 0, AND. We 
couldn't write 0...4095/(DB 00 E6), since this would search for the 8 
enclosed ASCII characters. We need a delimiter other than parentheses 
to tell ATE to interpret the enclosed characters as numerical bytes. 
We use a number sign # for this: 0...4095/#DB 00 E6# 

The bytes enclosed by the #'s must be expressed in the current 
operating base, which is set by the B command (see command summary). 
After typing B 8, we would type the above argument as 0. . .4095/#333 346# 

A feature of ATE that helps minimize typing: if a command needs an 

argument, but none is given, the interval computed for the last 

command is used. For example, here Is a common editing operation. 

First we view an interval of text to make sure it is the one we want. 

To do this we use the quote command " . 

" (THE)...(ING) } we type this. 

THE TEXT. 1 

^ P J the computer responds with this. 

The " command simply sends the addressed text to the terminal (inserting 
a line feed after a carriage return). After seeing the addressed text, 
we may decide to kill it: 
K 
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Since no argument Is given, it kills the most recently computed interval, 
namely (THE) . . . ( ING) . 

Suppose that after seeing the text, we decide that we only want to ki I I 
the word TEXT within it (but not any other occurrence of TEXT within our 
fi le). 
K /(TEXT) 

Remember that / takes the most recently computed interval and makes it 
the reference string. (Otherwise, the current file is the reference 
string.) In this case, the most recently computed interval is THE... ING 
from the previous argument. So the match will occur within THE... ING, If 
at all. 



Carriage returns occur frequently in most text, so there should be some 
way to address them. Trying to enclose one in parentheses wi I I not work, 
since that would terminate the argument prematurely. We could use the 
numerical value of the character, #D# (hex) or #15# (octal), but a more 
convenient and mneumonic character has been provided: -<- . For example, 
suppose we wanted to kill the first carriage return In our file (thus 
combining the 2 lines into 1). 

th 

Carriage return addressing Is one way to address lines in ATE. The n 

C+ +1-1 

line extends from the n- I carriage return to the n cr. , not including 

the former. For Instance, to quote the 3 line, we could type 

"2-«-. . . *- (although this will give us 2 cr.'s) 

Recall that after a ..., the search proceeds forward from the interval 

calculated so far. To view 4 lines starting at the second cr. , we could 

type 

"2-^. ..4-^ 

Notice that this will quote 4 lines, not 2. 
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rd 
What if we want to kill the 3 I ine without ki I I ing the or. that 

precedes it? Here is one way (although there is an easier way that 

we wi I I see shortly). 

To ki I I 4 lines starting just beyond the 2 or., we could type 
K 2-H-1...4<- 



Remember that all expressions in ATE evaluate to an interval, which 
is simply a pair of memory addresses. lnterval+1 simply adds 1 to 
both of these addresses. Thus, using our original example, (TEX)+1 
evaluates to the same thing as (EXT). 

What does (WR) . . . (XT. )+l evaluate to? Does the +1 apply to everything 
that comes before it, or just the (XT.)? Answer: just the (XT.). 
The + operator has a higher precedence than the ... operator, so it is 
performed first. Thus (WR). . . (XT. )+l extends from the W to the 
character after the period (which is a cr in this example). 

Here is another way to get the same interval: (WR). . . (XT. )-<- 
This introduces another -operator, concatenation . (XT. )-<- matches the 
first occurrence of the four characters X,T, period, and carriage 
return. 3(XT. )■*- would match the third occurrence of this four- 
character string. (As you can see, concatenation has a higher 
priority than ..., and a higher priority than "occurrenci ng". ) 

Some further examples: ■«-(PRINT)+l. . .-«- matches the first line beginning 
with PRINT. (We'll see an easier way to do this.) (ABD)(DEF) is 
equivalent to (ABCDEF). (ABC)-«-(DEF) is equivalent to (ABD)#D#(DEF) . 
No blanks are permitted between elements to be concatenated. In fact, 
no blanks are permitted at all in ATE arguments, except within 
I itera Is, as in (ING. ). 
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Another means of line addressing in ATE is the * operator. This takes an 

interval and expands it to a full line. In case the interval crosses a 

line boundary, it returns only the line containing the end of the interval. 
For examp le, 

kills the third line. The Interval 3<- is a l-character Interval contained 

rd 
in the 3 line. (It Is the carriage return at the end of this line.) 

^ expands this to the entire line. 

K<-(PRINT)* 

kills the line that begins with PRINT, not Including the preceding carriage 

return. 

"(TEXT)^ quotes the line containing the first occurrence of TEXT, whether 

or not It begins the line. 

"(TEXT) ... (TEXT)*, using our original example, results in the computer 

printi ng 

TEXT. 

ENTERING NEW TEXT. 

Notice that the * operator has a higher priority than the ... operator. 



There are a few more special symbols to make text addressing easier. @ 
matches any single character (as long as there Is one left in the 
reference string to match). (ABD)@(DEF) will match any occurrence of 
ABCJDEF, where the blank contains any single character. Contrast this 
to (ABD) . . . (DEF), which matches ABC thru DEF with any number of char- 
acters in between. Using an argument of 72@ would not only give the 
72 character in the reference string, it would test whether or not the 
reference string is at least 72 characters long. If not, the match would 
fail. (See the QF and QS commands for the consequences of match failure.) 

What if we wanted to match the first 72 characters of the reference 

n H 

string? (72@ only matches the 72 , not the first 72.) Here is one way: 

"...72@ 

This quotes the first 72 characters of the current file (If there are that 

many). In general, ... at the beginning or end of an Interval extends the 
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match to the beginning or end of the reference string. 

K 2-^*/... (NEW) 

will kill everything in the 2 line up to and including NEW. 

kills everything in the current file from the 77 line on. 



The symbols < and > refer to the left and right addresses of the most 
recently computed interval. They do not call for any matching, they 
simply return the appropriate address. K<+2...>-2 will kill every- 
thing In the most recently computed interval except the leading and 
trailing 2 characters. 

When ATE begins computing an argument, a new value is assigned 
to < as soon as the left address of an interval is computed. This 
a I I ows 

"(DO YOU, MR. JONES?).. .<+63, which quotes 64 characters starting 
with DO YOU... The symbol > retains its old value until the end of 
the interval is computed, either at the end of the argument or at a /. 



Summary of text addressing 

Most of the symbols below were covered in the preceding 
narrative. The rest are covered elsewhere as Indicated. 

Operands that invoke matching: 

( ) Matches the enclosed ASCII characters within the 

current reference string. 
# # Matches the enclosed bytes (expressed numerically 

In the current operating base). 
-^ Matches a carriage return. 

@ Matches any single character. 
Operands that return values without matching. 

number 1234 (decimal), 1234Q (octal), 0F12AH (hex). May 

also be expressed in byte-oriented or "split" 

fashion: 123:456Q (octal), 123:456 (decimal). 

In both cases, the 123 gives the value of the 
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high order byte, while 456 gives the value of 

the low order byte. 1:2Q = 001:002Q. Note 

that hex numbers are naturally byte-oriented: 

12:34H = 1234H. 
variable X, ABC, SI23, POINTER, etc. May be any length. 

16-bit integer values. See the = command. 
< Left address of most recently computed interval. 

> Right address of most recently computed interval, 

t Address of entry pointer. See the command summary. 

<F> The current file (beginning and ending addresses). 

<S> The source code area — all files. 

<T> The symbol table (see assembler). 

<R> The record most recently read in from tape. 

? The address of the most recent execution error 

(see programming). 
' ' The numerical value of one or two ASCII characters, 

e.g., '3»=63Q. 
& The assembly program counter. 

$ The assembly storage counter. 

Operators: 
Highest priority: 

Concatenation Applies when any match ing-type operands are juxtaposed, 
Middle priority (evaluated left-to-right) : 
+ Addition 

Subtraction 
* Expands the end of the preceding interval to a 

full line. Must be preceded in the same argument 
by an i nterva l-va lued operand, 
occurrencing Applies when a value precedes a matching operand. 

1+2 (ABC) is equivalent to 3(ABC). 
Lowest priority (evaluated left-to-rlght) : 

... Combines two intervals Into one. Can also be thought 

of as an operand that matches any number of 
characters. May be used repeatedly, e.g.. 
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(I HAVE).. (PAVEMENT).. (BEFORE). This would 
address the first 2 lines of the song "On 
the Street Where You Live," where 
(I HAVE).. (BEFORE) would address only the 
first line. Values connected by ... must 
be in non-decreasing order. 5.. 3.. 7 would 
fail. See the QF and QS commands. — 
may be shortened to a single . 
Takes the most recently computed Interval and 
makes it the reference string. 



An example 

The following page presents a "typical" editing session with 
ATE (typical in its use of the editing commands, not in the inanity 
of the text). The commands presented are E (enter), K (kill), 
M (move), R (repeat), t (set the entry pointer), " (quote), and 
* (quote one line). As each command is introduced, please refer 
to the command summary for a detailed explanation of what it does. 
Even more importantly, please make sure you have read the preceding 
section on text addressing. 

The > character at the beginning of a line Is a prompt issued 
by ATE when it is ready to receive a command. Note that blanks are 
optional everywhere except within command arguments, where they 
are illegal except within literals. 
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>E( ENTERING NEW TEXT NOTES 

WRITING THE TEXT 
KILLING AND MOVING TEXT 

) 1 

>".. 2 

ENTERING NEW TEXT 
WRITING THE TEXT 
KILLING AND MOVING TEXT 

>+.., M (WR)..(K), ". 3 

WRITING THE TEXT 
KENTERING NEW TEXT 
ILLING AND MOVING TEXT 
>K(K),K(IL).., ". 
WRITING THE TEXT 
ENTERING NEW TEXT 

>+(THE), ♦ 4 

WRITING -hTHE TEXT 

>E(IN )/ 5 

WRITING IN fTHE TEXT 

>+f+1,' 6 

WRITING IN TfHE TEXT 

>f+7,' 7 

WRITING IN THE TEXTf 
>E( BOOK 

IS FORBIDDEN), "..2-«- 8 

WRITING IN THE TEXT BOOK 
IS FORBIDDEN 

>"5*-* 9 

ENTERING NEW TEXT 

>K/(TEXT), ".. 10 

WRITING IN THE TEXT BOOK 
IS FORBIDDEN 
ENTERING NEW 

>» n 

ENTERING NEW + 

>K +-1, ' 12 

ENTERING NEW+ 

>E(CASTLE 

IS RISKY), ".. 

WRITING IN THE TEXT BOOK 

IS FORBIDDEN 

ENTERING NEWCASTLE 

IS RISKY 

>R99,K(IS),E(WILL BE) 13 

? 

WRITING IN THE TEXT BOOK 

WILL BE FORBIDDEN 

ENTERING NEWCASTLE 

WILL BE RWILL BEKY 

>K 3(WILL BE), E(IS), ".. 14 

WRITING IN THE TEXT BOOK 

WILL BE FORBIDDEN 

ENTERING NEWCASTLE 

WILL BE RISKY 

>f(IN ),E("),M(ENT)..(KY),E(" ),". 15 

WRITING "ENTERING NEWCASTLE 

WILL BE RISKY" IN THE TEXT BOOK 

WILL BE FORBIDDEN 

> 16 
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Notes 

1. When ATE is first powered up, it initializes an empty file (among 
other things), issues a prompt character > , and waits for a command. 
In this case, the first command is an Enter. After typing the 
third line, we typed a carriage return before typing the closing 
parenthesis. This Isn^t strictly necessary, but if a file contains 
more than one line, it is good practice to end every line, including 
the last, with a carriage return. 

2. In this example, we have used two dots .. for readability. Most 
often, you will probably only want to use one dot for brevity. 

3. t.. sets the entry pointer to the beginning address of its argument. 
Since .. matches the entire reference string, and since the 
reference string is the current file unless otherwise indicated, 

t. . sets the entry pointer to the beginning of the file. This 
pointer also indicates the destination of an M (move) command, as 
this example shows. (After the move, the pointer is updated to the 
end of the inserted material, ready for additional entries or moves. 
See #15 below.) 

4. This introduces the single-quote ' command. See the command summary. 

5. Note that we inserted 3 ASCII characters, and that the pointer was 
updated past the inserted material, 

6. The character t, when used as a command, means set the pointer to 
the beginning of the following interval. When used in an argument, 
it returns the (old) address of the pointer. Thus ft+1 is analogous 
to X=X+1 with the = command. (But note that the t command does not 
use an equa I sign. ) 

7. This shows that ATE will recognize t+7 as an abbreviated version of 
tt+7. Note that the entry pointer is now set between the letter 

T and a carriage return. 

8. Here we have asked ATE to quote everything in the file up through 
the 2 carriage return, i.e., the first two lines. 

9. Quote the line containing the 3 carriage return, i.e., the third 
line. See the explanation of * under text addressing. 



0. Recall that / takes the most recently computed interval (in this 
case the 3 line) and makes it the reference string. This way, 
we won't kill any other occurrence of TEXT within the file. 
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11. Note that no matter where it was before, the entry pointer is left In 
the position of the deleted text. 

12. Here we are killing the character just before the pointer, again 
leaving the pointer in the place of the deleted text. (The deleted 
character was a blank.) 

13. R means repeat. After 3 times, ATE could find no more occurrences of 
IS, so it responded with a ?. 

14. Here we are saying "kill the 3 occurrence of WILL BE". In a large 
file, we probably would have quoted the offending text, and then used 
the restriction operator / . 

15. Notice that the entry pointer is continually updated throughout this 
process. 

16. We have left 2 carriage returns at the end of the f i le, as we can see 
by the empty line that was quoted there. See the programming commands 
for an example of an editing macro that can be used to clean up a f i le 
that has accumulated adjacent carriage returns and blanks. 



ATE Command Summary 

Line Typing 

Rubout Deletes the last character, echoing a back-slash \ . 

Control-Z Deletes the line being typed, echoing a back-slash, carriage 
return, and line feed. 

Control-A While ATE is typing output or running a program, hitting any 

key will halt the current process (without otherwise affecting 
it) and wait for you to peruse the output (or whatever). At 
this point, typing control-A will abort the process and return 
control to the terminal. Hitting any other non-printing 
character will continue the process where it left off. 

Note: With the exception of the above three characters, ATE will 
ignore whatever is being typed until the line is terminated by a 
carriage return. But if the line being typed exceeds 72 characters, 
ATE wilt echo a back-slash after each additional character to 
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Indicate that the character has been lost. The "terminal width" 
can be set to less than 72 characters If desired (see the section 
on Initialization). If the line being typed exceeds the terminal 
width, ATE supplies a new line (crif) automatically and lets you 
continue typing the line (until the 72 character limit). The 
automatic carriage return and line feed will not be part of the 
I Ine. 

The terminal width can be set to exceed 72 characters in 
order to obtain a wider printout, but Input lines will still be 
limited to 72 characters. 

If you set the terminal width too small, the printout will 
not be wide enough to accommodate an assembly listing. In that 
case, see the address LISTR In the appendix for a patch. 



ATE Command Summary 

Note: Most of ATE's power lies in the arguments that you can give 
to Its commands, not In the commands themselves.- All command arguments 
have the same format, which Is explained in the section on text 
address I ng. 

Basic Editing Commands 

f "Set pointer." ATE maintains an entry pointer to indicate where 
text is to be entered, or what the destination of a Move or Copy 
instruction is. Using f as a command will assign the beginning 
address of the argument to this entry pointer. For instance, 
suppose that WRITING Is the first word In the current file. 
f(TING) will leave the entry pointer pointing to the letter T. 
However, It Is customary to think of t as pointing between the 
T and the preceding I, WRItTING, since that Is where entered 
text will appear. So when you type f(TING), It helps to think 
"set the pointer to precede TING." 
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The t character may also be used in an argument to reference 
the entry pointer address. For instance, continuing the above 
example, typing "t would cause ATE to respond with a T. Typing tt+1 
will increment the pointer. As a special case, ATE will recognize 
the commandt+l as an abbreviation of it+1, not as an attempt to set 
the pointer to the absolute address 1. (To do this, you could type 
tl. ) You may use an absolute address (a number or a variable, 
instead of a matching operand) and set the pointer outside of your 
text files altogether. In this case, the Enter command will behave 
somewhat differently. See the Enter summary for a full explanation. 

As is the case with all ATE commands that take an argument, t 
may be typed without an argument, in which case the most recently 

computed argument will be assumed. For instance, after typing 

rd 
"3^^ to view the 3 line, we could type t,E( LABEL) to insert LABEL 

at the beginning of this line. Or we could type t>,E(COMMENT) to 
append COMMENT to the end of the line. In fact, after viewing the 
3rd line with "3^^, we could type the following: 
t,E(LABEL),t> ,E(COMMENT) 

to accomplish both these operations. To understand why this works, 
read about the Enter and Move commands. In a nutshell: the Enter 
command does not change the default argument. But it may cause 
text to be moved (to expand thefile), and whenever ATE moves any- 
thing that it knows about (such as >, <, the file, the symbol 
table, etc.), it remembers the new location. 

The only commands that affect the position of the entry 
pointer are: t,E,K,M,C,F,N,0, and L. t sets it to the beginning 
of the addressed Interval, K sets it to the deletion point, and all 
others set it to the end of the interval in question. 
"Enter." Text which follows the E command (as long as it is 
properly delimited) is entered at t, and t is set past the entered 
material, ready for continued entry. The text to be entered must 
be delimited in the same manner as for match ing-type operands: 
parentheses around ASCII characters, and number-signs around numeri- 
cal ly expressed bytes. These two types can be concatenated (with 
no intervening space), as can the symbol -<- for carriage return. 
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However, in contrast to match ing-type operands, the delimited 
text can be many lines long, i.e., it can contain carriage returns 
Also, no matching takes place. ATE does not compute any new 
argument values for the E command, so the default argument (the 
most recently computed interval) remains unchanged. 

The interpretation of what it means to "enter the text at 
t" is necessarily different depending on whether or not t lies 
within a text (source) file. If it does lie within a source file, 
then we think of t as pointing between characters (just before 
the one it was addressed to). The source file (and any adjacent 
f i les in the source code area — see the memory file commands for 
an explanation) is expanded and the given text is inserted. If 
t is not in any source file recognized by ATE, then the given 
text simply overwrites what is already in memory, beginning right 
at f . This latter operation is used most often in editing object 
code (= machine language program). For an example of this, see 
the # command. 

It is legal to include parentheses In the ASCII text to 
be entered, as long as they are balanced, i.e., as long as they 
occur in matched pairs. For instance, E(LET X=SIN(Y)) is legal. 
It will enter all but the outer-most parentheses. In ATE, this 
feature Is often used as follows. We might type: 
E(*BLANKS, QF( ), K<, (^BLANKS)) 

This enters a string of ATE commands (most of which we haven't 
covered yet) Into a file. Later, we might ask ATE to execute 
these commands. Their effect would be to eliminate multiple 
blanks in whatever file was then current. This is called an edit 
macro, and will be covered with the programming commands. 

Error handling: suppose that the current operating base 
is 16, and you type E#C3 12 AX# . ATE wi I I enter the C3 and 
the 12, but It will not recognize the X as a legitimate base 16 
digit. t will be updated past the entered 12, and an error 
sign ? wi I I appear at the terminal. Then you could type E#AC# 
( I f AC was your intention) to complete the operation. 
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K "Kill." The addressed text is deleted, and t (no matter where it 
was before) is set to the deletion spot. Thus a Ki I I followed by 
an Enter wi i I replace the deleted text, with no need to use the t 
command. For instance, 

K(SAMUEL CLEMENS), E(MARK TWAIN) replaces the first occurrence of 
SAMUEL CLEMENS With MARK TWAIN. R999, K(SAMUEL CLEMENS), ECMARK 
TWAIN) will replace all occurrences (unless the text is extra- 
ordinarily repetitious of that name). (See the Repeat command.) 
As with Enter, Kill behaves differently when used to edit 
object code, i.e., memory data outside a text file. If the 
addressed text is inside a source (text) file, then it is moved 
outside the source file area, and the remaining source code is 
compacted to fill the gap. (Thus the killed text is not actually 
overwritten, and can be retrieved, unti I the next Enter causes the 
source area to expand.) But if the addressed interval is outside 
the source area, then it is zeroed , i.e., the addressed interval 
is filled with zeros, and t is left pointing to the first zero. 

Machine language example: Suppose we have a version of 
Basic whose input routine we want to change. From the documentation, 
we know that it does teletype 10 using the Processor Technology 
standard ports (0 for status, 1 for data). We could load Basic at, 
say, 3000H and then type the following: 
K 3000H..5000H/#DB 00 E6#@@@@#DB 01# 
E #CD El 23# 

What we have done is put zeros (NOPS) in place of the old input code, 
and then put in a call to our new input routine at the beginning of 
this zeroed section. We used the four @'s so that we didn't have 
to worry about what the mask was, whether the jump was a JZ or JNZ, 
and what the jump address was. 

In actual practice, we would want to look at the code before 
we zeroed it. See the # command for an example of this. 

M "Move." The addressed text is removed from Its present location 

and inserted at the entry pointer. The pointer is updated past the 
inserted material, ready for additional moves or entries. If the 
addressed text included any of the internal pointers known to ATE, 
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then these are updated to their new location. These are: <F> 
(the current file), <S> (the source area), <T> (the symbol 
table), <R> (the record most recently read in from tape), < 
(the left address of the most recently computed interval), > 
(the right address of the same), the user command table, the 
command interpretation pointer (in case a macro is currently 
executing), and any return or repeat addresses. The Kill command 
uses the same subroutines to move text out of the source area, and 
the Enter command uses them to expand the source area if necessary. 

Example: To put lines 10 through 12 between lines 2 and 3, 
t3<-^, M 10-^-^.. 2^ Or we could type 
f2^+l, M 9^+1.. 3^ 

In either case, if we then typed a " command without an argument, 
we would see the text that had been lines 10 through 12, but in 
the new location, t wi I I now be at the end of these lines, but 
if we want it at the beginning, all we have to do is type + 
without an argument (or type t<). 

As with the Enter command. Move behaves somewhat differently 
when used to edit object code. If t is outside the source area, 
then the addressed interval is simply copied to t, overwriting 
what is already there. This happens no matter where the addressed 
interval is, and the original interval remains unchanged (unless t 
was within it). For example, to move the symbol table up 100 
bytes: f<T>+100, M<T> 

If you didn't want ATE to know about the new copy of the symbol 
table, you would use the Copy command. 

"Copy." This is a seldom-used command. It copies the addressed 
interval to t, overwriting what is already there, and updates ^ 
past the copied material. There are two differences between 
this and the Move command. (A) Copy is insensitive to whether 
or not t lies within source code. Even if it does. Copy simply 
overwrites what is there; it never expands and inserts. So you 
will probably not want to Copy anything into a source file. 
(B) Copy "hides" the new location of the copied material from 
ATE, i.e., none of ATE*s internal pointers are updated. One 
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example of when you might find this useful: you might want to 
create a duplicate copy of (say) the current file somewhere else 
in memory, without having that copy actually become the current 
fi le. 



Printing Commands 

" "Quote." Sends the addressed characters to the terminal, inserting 

a line feed after each carriage return. For example 

>"(THE)..(NEW) 

THE TEXT 

ENTERING NEW 

If the terminal prints garbage in response to this command, you have 

probably given it an argument outside your source files. In that 

case, you probably wanted to have the characters expressed numerically, 

Use the # command for this. 

' "Quote one line." Takes no argument. This quotes the line 

containing the entry pointer, showing the position of this pointer 

by a 4^ character. The '^ appears just before the position to which 

it is addressed, since this is where Entered or Moved text will 

appear. For instance: 

>t(E T), ', E(ES), ♦ 

WRITING THtE TEXT 

WRITING THESfE TEXT 

Using ' does not affect the default argument. 

P "Print." This Is mainly used with assembly language programs. It 
prints the lines containing the addressed text in assembly language 
format. Each line is given a line number (which is not part of the 
text). The first line of the file Is 1, the second Is 2, etc. 
Here is an example that shows the difference between " and P. 
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>"(IN )..(MASK) 
IN STATUS GET THE STATUS BYTE 
AN I MASK 
>P 

79 INCHR IN STATUS GET THE STATUS BYTE 

80 AN! MASK SCREEN OFF IRRELEVANT BITS 
>" 

IN STATUS GET THE STATUS BYTE 
AN I MASK 
Note that P only prints entire lines, even if the argument 
does not come up to line boundaries. But this does not change 
the default argument — it remains exactly as typed. (No 
implicit ^ operation is performed.) 

P can be used to get the line number of a non-assembly- 
language line, even though the output will be strange. (The 
listing can be control-A'ed. ) 

"Base." Sets the current operating base to the given value. 
This does not produce any output itself, but subsequently all 
numerical output will be generated in this base. The only 
effect on input is that numerically-expressed bytes delimited 
by #*s in command arguments must be expressed in this base. 
The base may not be less than 5. Typing B8 gives you 
octal, BIO gives decimal, and B16 gives hex. 

"Quote numbers." This is simi lar to the "command, except that 
the characters are expressed numerically in the current operating 
base. The beginning address of the interval is printed, 
followed by up to b (=base) bytes, and then followed if necessary 
by more such lines. (This command is often called "Dump" in 
other systems. ) 

Machine language example: (This expands the example 
given with the Kill command.) Suppose we have a version of Basic 
whose input routine we want to modify. From its documentation, 
we know that it comes set up for teletype ID using Processor 
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Technology standard ports (0 for status, 1 for data). We can load 
Basic at (say) 3000H, and then look for the machine language code 

for IN 0, ANI , fol lowed by IN 1. 

># 3000H..5000H/#DB 00 E6#..#DB 01# 

31DA DB 00 E6 80 CA DA 01 DB 01 

>K, E#C3 #1 23#, # 

31DA C3 El 23 00 00 00 00 00 00 

After looking at the code and deciding that it was what we wanted, 

we zeroed it, entered a ca I I to our new input routine, and then 

looked at it again to confirm that the change was made correctly. 

"Where?" Prints the beginning and ending addresses of the argument. 
For example, ?.. will give the addresses of the current file. 
(Note: this works unless the file is empty. .. is a matching 
operator, and it will fail if the reference string is empty. On the 
other hand, <F> is an operand that returns values without matching, 
so ?<F> will always work.) 



Memory Fi le Commands 

ATE keeps its text files adjacent in one area of memory, 
called the "source area," denoted <S>. The left address of <S> 
is ordinarily fixed (although It may be changed by M<S> or by an 
command), while the right address varies dynamically In response 
to enter and ki I I commands. <S> consists of a zero byte, fol lowed 
by the first file, followed by another zero byte, followed by the 
second file, etc., ending with a zero byte. There is no limit on 
the number of files. No separate file directory is maintained; 
files can be accessed (via the F command) by addressing any of 
their contents. By convention, files can be "named" by entering a 
uniquely identifying name as the first line. (The name should be 
preceded by a * I f the file is going to be assembled.) The F com- 
mand can then address this name. No check is made to keep <S> from 
overflowing memory, but the user can periodically check its size 
by typing ?<S> . 
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"File." This finds the file containing the given argument, makes 
It current, and sets t to the end of the file. Unlike any 
command covered so far, the initial reference string of this 
command is <S>, not <F> . So for instance, F(WRITING) will find 
the first occurrence of WRITING within the source area, and then 
make the file that contains this current. 

If for some reason you have memory files isolated from the 
source area (by use of the command, perhaps, or by loading from 
a peripheral not recognized by ATE), you can access them by 
giving an absolute address with the F command. Suppose you have 
loaded a file from a disk at address 4000H. As long as the 
limiting zeros are in place , you can type F 4000H . ATE will 
look forwards and backwards for the limiting zeros. If the given 
address contains a zero, ATE assumes that it is the beginning of 
the file. 

After finding the file boundaries, ATE checks the 
relationship of these boundaries to the source area. If the 
f i le is within the source area, it is made current, t is set to 
the end, and nothing else happens. But in addition, if one 
edge of the file is within <S> while the other isn*t, then <S> 
is expanded to include the new file. If the new file is 
entirely outside <S> , then ATE forgets the old source area 
(leaving it intact) and adopts the new file as the new source 
area. The old source area can be recovered later by repeated 
use of the F command, or with the command. 

"New file." Opens a new, empty file at the top of the source 
area and makes it current, ready for entry. Specifically, a 
zero is written into memory just beyond the last zero in the 
source area. <S> is expanded to include this new zero, and 
the current file pointers and the entry pointer are set to the 
empty file between these two zeroes. Note that N does not take 
an argument. 
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"Originate new source area." Sets up a new source area at the given 
address (es ) . If only one address Is given, as i n 3000H, then two 
consecutive zeros are written into memory starting at this address 
(at 3000H and 3001H, for example). If two addresses are given, as 
in 3000H. .36DAH, then zeros are written at these addresses. In 
either case, the last (possibly empty) file of this new source area 
is made current, and t is set to its end. 



Programming commands 

ATE can create (and edit) source files which are actually 
strings of ATE commands. Later, these commands can be executed 
by typing a D or > command addressed to the desired point. 

D "Do." This is analagous to an assembly language CALL or a Basic 
GOSUB. ATE remembers the location of this command, computes the 
argument, and then starts executing commands at this address (the 
beginning address of the argument). In computing the argument, 
the initial reference string is <S> . ATE will continue executing 
commands unti I it encounters an end-of-f i le or one of the Quit 
commands, at which point it will return to the command following 
the Do. If there is no command followjng the Do and no previous 
Do to return to, or i f an error is encountered, control returns 
to the terminal. See the end of this section for an example of 
an ATE program using Do's. 

Do's may be nested. To see how deeply they can be nested, 
you could type the following: 

N, E(X=X+1, D(X=X+i)), X=0, D(X=X+1) 
This line creates and then executes an ATE program. The trouble 
with this program is that it never lets ATE return from the Do. 
It keeps executing Do's until ATE runs out of storage for return 
addresses. At that point, ATE Issues an error sign (a ?) and returns 
control to the terminal. (See "Error Handling" for more Information.) 
You could then type #X or ?X to see how many Do's had been stored. 
(Note: the return address storage area is also shared by the Repeat 
command. ) 
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Notice that when ATE sees D(X=X+1), it does not Immediately 
increment X. Instead, it stores the return address, searches the 
source area for the first occurrence of the string X=X+1, and 
then begins executing commands at that point. 

Rather than address commands directly, as in D(X=X+1), we 
usually address labels, as in D(*COUNT). See the ^ command below. 
For maximum brevity, we can use a variable to hold the absolute 
address of the desired command. We could say Y=(X=X+1) or 
Y=(*COUNT), and later type DY. This is useful for often-repeated 
edit macros (see the example at the end of this section). But 
then we must be careful not to change the absolute location of 
the command by some edit operation. Placing it at the bottom 
of the source area (or in an isolated source area) will ensure 
against this. 

Caution: D(STRING) contains an occurrence of STRING. If 
you want to address an occurrence of STRING at some later point 
In the program, you could use D 2(STRING). 

"Goto." Causes ATE to execute commands beginning at the given 
address. Like Do, > may be used within a program, or it may be 
used to start a program from the terminal. Unlike Do, no return 
address is stored, so ATE will never automatically return to the 
succeeding command. As with D, the initial reference string is 
<S> . (The only ATE commands for which this is true are F, D, 
and > . Note that the initial reference string never includes 
the command line being typed.) Here is a simple example. Note 
that the prompt character is not a Goto command. 
>N, E("(HELP, I'M TRAPPED IN AN INFINITE LOOP ),>("))., X") 
This command line creates and executes a program that quotes 
HELP, I'M TRAPPED IN AN INFINITE LOOP indefinitely until 
control -A' ed. 



* 
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"Repeat." May be used in a program or In the command line. If 
used In a program, the rest of the file up to an end-of-flle zero 
byte, or up to a Quit command (see below) Is repeated the given 
number of times, (if this value is 0, the following commands are 
not executed.) When the repetition is exhausted, a return is 
performed (to an outer loop or to a Do, whichever is more recent, 
or to the terminal). For example: 

N, E(S=0,N=0,R 100,N=N+1,S=S+N), D(S=0), #S 
This creates and executes a program that finds the sum of the 
integers 1 to 100. 

When R is used directly in a command line, then the rest of 
that line will be repeated the given number of times before con- 
trol returns to the terminal (unless an error or a control -A 
forces an early return). For instance, R999, K( SOON) ,E( IMMEDIATELY) 
will replace all occurrences of SOON with IMMEDIATELY and then 
return with an error sign ? when it can find no more. 
tOCCOOH, R1024, E( ) will clear the screen of your VDM (i.e., 
it wi I I fill IK of memory, beginning at OCCOOH, with b lanks) . 

"Label." This use of ^ is similar to its use in assembly language- 
it tells the system to ignore the following characters. (This has 
no relation to ^'s use as a line operator in command arguments.) 
When ATE encounters a * as a command, it skips ahead to the next 
command, ignoring all intervening characters. Thus these inter- 
vening characters can be a mneumonic label for that point in the 
program. For example, we could create a program as follows: 
>N, E(^BLANKS, K( ), E( ), X^BLANKS)) 

Later, whenever we wanted to eliminate double blanks from the 
current file, we could type 
> X^BLANKS) 

We could use a shorter mneumonic, of course. This program has the 
defect that It will always end with an error, when no more double 
blanks can be found. So it cannot be called by a Do command with 
any hope of returning. For this we need the Quit commands. 

Specifically, * causes ATE to skip ahead to the next blank. 
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comma, carriage return, or end-of-f i le (zero), whichever comes 
f i rst. 

Error IHandJ ing ; Ordinarily, any error in a command argument causes ATE 
to stop an execution, issue an error sign ?, and return control 
to the terminal. To see what caused the error, you could type 
>" ?-5..? 

This will quote 6 characters from the program, ending with the one 
that ATE was looking at when it gave up. (Of course, any other 
number of characters could be used.) For Instance, suppose we 
executed ^BLANKS given above. 
> X ^BLANKS) 
? 

>" ?-5..? 

K( ), 

This shows that ATE was unable to evaluate the argument to the K 

command, i.e., it could not find any more adjacent blanks in the 

current f i le. 

QF "Quit on Failure." In general, both quit commands (QF and QS) 

mean "quit this subroutine." When the argument to QF is evaluated, 
a match fai I ure or a comparison failure will not abort the 
program. Instead, it will cause a return to the latest Do or to 
the terminal. In performing this return, one Repeat loop will 
be broken, if present. If Repeats are nested, the outer loops 
will not be broken. 

Examples: We can use this command to repair the defect 
in our program ^BLANKS mentioned above (with the ^ command). 
^BLANKS, QF( ), K>, X^BLANKS) 

Now this routine can be called with a Do. As long as there are 
adjacent blanks in the current file, this will Kill one of them 
and loop. When it cannot find any more adjacent blanks, the QF 
will force a return instead of an error. 

Since QF will break a repeat loop, we could also write 
^BLANKS this way: ^BLANKS, R9999, QF( ) , K> 
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In addition to match failure, QF will force a return instead 
of an error on a comparison failure . Values connected by . . . must 
be in non-decreasing order. So QF X..Y will succeed and continue 
if X^Y, and will fail and return if X>Y. More than two values at 
a time may be checked, as in QF X..Y..Z . QF X..Y.,X will return 
if Xj^Y. 

QS "Quit on Success." This is the same as QF above, except that it 
forces a return if its argument is successfully computed. If a 
match failure or comparison failure occurs In the argument, then 
execution continues. If any other kind of error occurs in the 
argument, the program is aborted and control returns to the terminal. 
For an example, see the end of the section on cassette commands. 

= "Equals." This is the only command that doesn't precede its 

arguments. It is used in the conventional manner to set the value 
of a variable, e.g., X=X+1, POINTER=VALUE, Sl=-1, etc. Blanks 
around the = are optional. Variables can be any length, must 
start with a letter, and may contain only upper case letters and 
digits. Values are 16 bit unsigned integers. (So Sl=-1 is 
equivalent to S1=0FFFFH) Any ATE argument (including no argument) 
may occur to the right of the =. The variable on the left is 
assigned the beginning address of the (default) argument. F=2(X=X+1) 
assigns the address of the 2 occurrence of the string X=X+I to 
the variable F. X=, Y=> saves the current default argument in X and 
Y (although it creates a new default argument). 

Variables are kept in a symbol table shared with the assembler. 
This allows you to set external references prior to an assembly, and 
to address object code symbolically after an assembly. See the Z 
commands for more information. 

X "Execute." This is used to call machine language subroutines (as 
opposed to D which calls ATE subroutines). The machine language 
routine may end with a RET (as long as the stack has not been 
lost) in which case X can be part of any ATE command line or program 
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just like any other ATE command. You have between 20 and 40 
stack levels (40 to 80 bytes) depending on how deeply nested 
the Do*s and Repeats are when the X is encountered. If your 
routine loses the stack, it should end with a jump to address 
SYSl (see appendix). This returns control to the terminal 
Ignoring any commands following the X. 

Your routine can evaluate an ATE argument: 
X ROUTINE X..Y, OTHER COMMANDS 

Leave a space between the address of your routine (which you can 
set with an =, e.g., R0UTiNE=3456H) and the argument you want to 
evaluate. X..Y can be any ATE argument. Your routine can CALL 
address CVALS (see the appendix). On return, HL and DE will 
contain the beginning and ending values of the argument. 
Additional arguments can be evaluated by repeated calls to CVALS, 
as long as the additional arguments are separated in the command 
line by blanks, not commas or carriage returns. 

User machine language routines can also be accessed by 
entering a name and address for the routine into the user 
command table (explained later). 

Example of a useful ATE program 

This is a program (or "edit macro") to "clean up" an 
English language file after extensive editing. Unless you are 
quite careful when editing such a file, you will probably end 
up with lots of adjacent blanks and very short or long lines 
that will spoi I the looks of the file when it is printed out. 
After creating the following program, typing D(*CLEAN) will 
eliminate multiple blanks and fix the carriage returns so that 
each line is ^ LENGTH long. (Don»t forget to set LENGTH first, 
e.g., LENGTH=72.) 

*CLEAN uses three subroutines: *CRS replaces all 
carriage returns with blanks. *BLS eliminates multiple blanks. 
*LNS fixes the line length. 
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^CRS, QF-^, K, E( ), > 

^BLS, QF( ), K>, X^BLS) 

*LNS, QF t..LENGTH@, K /- 1 ( ), E-^, >(*LNS) 

^CLEAN, D(^CRS), D(^BLS), f . . , D(^LNS) 

This program can easily be extended to detect special symbols and 
replace them with new paragraphs (a carriage return and several 
spaces), or new pages (several carriage returns, depending on the 
number of cr's since the last new page). 



Introduction to the ATE assembler 



If you already have some experience with assembly language programming, 
you should skip ahead and read the Assembler Summary. If any of the summary 
is unclear to you, then come back and read this introduction. 

If you haven't had any experience with 8080 machine language (in 
particular, if you haven't learned the instruction mneumonlcs such as 
CALL and XCHG and what they do), then you should read a text on 8080 
machine language before continuing. • 

This manual assumes that you know at least enough about 8080 
machine language programming to* code the following subroutine: 
Take the byte in the memory location addressed by the HL 
register pair, add it to the byte addressed by the DE 
register pair, and store the result at the address in the BC 
register pai r. 
If you were doing all your programming by hand through the front panel 
keys or switches, you might first write down the mneumonics for the 
desired instructions, look up their values in a table, and key these 
values into memory: 

Mneumoni cs Hex Octa I 

LDAX D lA 032 

ADD M 86 206 

STAX B 02 002 

RET C9 311 
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For this little subroutine, there Is not much work Involved. But 
when you try to write larger programs this way, you begin to wish that 
your computer could do some of the busy-work for you. The first step — 
figuring out the Instructions that will do thejob — Is not always busy- 
work. Sometimes this may involve ingenuity. But the second and third 
steps are easily automated. Looking up mneumonics in tables and putting 
the values where they belong in memory are the major tasks of an assembler . 

Example I . Power up ATE and type the following. (The > sign at the 
beginning of a line Is a prompt issued by ATE when It is waiting for 
a command. No prompt is Issued while you are entering text. Notice 
that we put each mneumonic on a separate line, and precede each one 
with a blank. The reason for this will be covered shortly.) 



>E( LDAX D 

ADD M 

STAX D 

RET) 
>G 

0000 lA 

0001 86 

0002 02 

0003 C9 



You type this. 



1 


LDAX D 


2 


ADD M 


3 


STAX B 


4 


RET 



ATE responds with this. 



Here is what we have just done: We E^ntered the mneumonics into a file 
in the computer's memory, and then we told ATE to Generate a machine 
language program from these mneumonics. ATE stored the resulting 
machine instructions in memory starting at address 0, and 
printed out the hex code for each instruction along with the mneumonic 
that produced it. (It also numbered these mneumonics for later 
reference.) Of course, we could have told ATE to use some other 
address than — this will be covered later. And we could have told 
ATE to use octal or decimal, rather than hex, by typing B8 or BIO 
(see the B command). 
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In order to use the subroutine that we have just written, we of 
course need to ca I I it. We don't want to write CALL each time, 
however. We want to give the subroutine a name and write the following 

CALL MADD 



MADD LDAX D 

ADD M 

STAX B 

RET 
This way, we don't have to know the address of the subroutine while we 
are writing the program — we can let ATE figure this out later. 

Example 2 . Type the following. (Notice that we are using some of the 
text editing features of ATE. We will explain them briefly in the notes 
below. They are described fully elsewhere in this manual.) 

notes 
>t. 1 

>E( CALL MADD 
* 2 

MADD) 

>". 3 

CALL MADD 

MADD LDAX D 

ADD M 

STAX B 

RET 
>P. 

1 CALL MADD 4 

2 ^ 
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3 


^f 




4 


MADD 


LDAX D 


5 
6 




ADD M 
STAX B 


7 




RET 



Notes (1) f stands for the "entry pointer", i.e., the position in the 
current f i le at which new text will be entered. The dot "." as it is 
used here stands for the current file. t. tells ATE to position the 
entry pointer at the beginning of the current f i le. Note that the 
current file already contains the mneumonlcs from example 1. 

(2) An ^ at the beginning of a line (i.e., not preceded by a 
space) has a special meaning to the ATE assembler. We can put 
anything we want on the rest of the line (including nothing), and 
the assembler will ignore the whole line. This lets us comment our 
programs and "space out" the instruction mneuonics. 

(3) ". tel Is ATE to quote the current file. This shows us the 
file as it resides in memory. Notice that the instruction mneumonics 
are preceded by blanks, but the ^'s and the subroutine label MADD are 
not preceded by blanks. 

(4) P. tel Is ATE to print the current file. Spaces and I ine 
numbers are added to the printout to make the assembly language easier 
to read. 

Example 3 . Now let's assemble this program. 



>G 

0004 CD 00 00 



0007 lA 

0008 86 

0009 02 
OOOA C9 



1 




CALL MADD 


2 


¥: 




3 


^ 




4 


MADD 


LDAX D 


5 




ADD M 


6 




STAX B 


7 




RET 
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The "A" In the first line of the program listing Is an error message . 
It stands for argument error : ATE did not know the value of the 
argument to the CALL instruction, i.e., it did not know the address 
of the MADD subroutine. 

The problem is this: the assembler looks at the program one 
line at a time, beginning with the first line. When ATE saw CALL 
MADD, it had not yet come to the subroutine labeled MADD, so it 
did not know what address to use with the CALL instruction. So it 
simply used an address of and flagged an error. 

This is often called the "forward reference" problem. One way 
to solve It would be to have ATE look forward through the program, 
counting instruction bytes until It comes to MADD. Then It could 
go back to the CALL MADD instruction with the correct address. But 
the trouble with this is that the program might be on tape (if it 
were too large for memory), and moving tape back and forth is very 
time consuming. 

To get around this, we would like ATE to look over the enti re 
program once, before it begins to print anything. This way it can 
figure out the address of the subroutine MADD (and any other 
subroutine) before it actual ly needs it. It can store the label 
MADD together with the proper address in a symbol table . Then 
later when It sees CALL MADD, it can look In this table to find 
the appropriate address. 

What this all boi Is down to is that the assembler can make two 
passes over our program. On pass 1, it reads through the program 
and constructs a symbol table, i.e., a list of labels and their 
corresponding machine language addresses. Then on pass 2, it rereads 
the program and actually generates the machine language instructions 
and stores them in memory. 

The command A tells ATE to do pass I. (It stands for A_ssemble 
the symbol table.) It is not necessary if the program has no labels 
(as in example I) or if the symbol table Is already in memory 
(possibly restored from tape). The command G (for Generate machine 
language) tel Is ATE to do pass 2. We can command ATE to do both 
passes by typing A,G . (Most assembly language systems don't let 
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you command the two passes separately. They use a single command such as 
ASSM where ATE would use A,G. But there are real advantages to the.A,G 
approach, as we will see.) 

Examp le 4 . The current file still contains the same program as in 
example 3. Suppose we now type 



>Z,A 



The first command Z (Zero the symbol table) simply makes sure that we are 
starting out with a clean slate. It removes any old symbols that might 
be left over from a previous programming session. (Sometimes we want to 
save these symbols. More about this later.) The A command then does 
pass 1 over our program and puts MADD (and any other labels) into the 
symbol table. (Notice that this does not produce any printout.) To 
see that ATE does know the address of MADD now, we can type 

>?MADD 
OOOE OOOE 

(To see why ATE responds with two values, try typing ?MADD. .MADD+9) 
Now we can do pass 2 over our program. 



>G 

OOOB CD OE 00 



OOOE I A 

000 F 86- 

0010 02 

0011 C9 



This time there was no error. Note: we could have typed Z,A,G a 
on one line to accomplish the same thing. 



1 




CALL MADD 


2 


^ 




3 


^ 




4 


MADD 


LDAX D 


5 




ADD M 


6 




STAX B 


7 




RET 
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How do we tell ATE where in memory to store the assembled machine 
language? Actually, there are two problems here, (a) Where in memory 
will the machine language program be located when it is executing? and 
(b) Should the program be temporarily stored somewhere else first? For 
instance, we might want to assemble a program that will begin executing 
at address lOOOH. But ATE itself begins at lOOOH, so we would want the 
assembler to store the new machine language somewhere out of the way unti i 
we are ready to use it. 

The symbol & stands for the "assembly program counter" (remember 
that they both begin with an "a"). This holds the execution address of 
the instructions being assembled. The symbol $ stands for the "storage 
pointer" (remember that they both begin with an "s"). This holds the 
address where the assembled instructions are being stored . (In many 
assembly language systems, $ stands for both; the two uses cannot be 
separated.) For example, we can use & and $ as commands: 
>&1000H,$0D00H 

This tel Is ATE to set the assembly program counter to lOOOH, and set the 
storage pointer to ODOO. Now, the next program to be assembled will be 
stored at ODOO. But it will have to be loaded at address lOOO in order to 
execute properly. (In more detail: the next A command will assemble 
the symbol table assuming that the program begins at address lOOO. Thus 
all CALL and JMP addresses will be based on this starting address. 
The next G command will use the symbol table and generate machine language, 
but will store this machine language beginning at ODOO.) 

Examp le 5 . Let's write a new program. 

>N 

>E( FIRST LXI H,1234H 

SECOND MVI A,l 

JMP FIRST 

JMP SECOND THIS IS A SILLY PROGRAM 

) 

>&1000H,$0D00H,Z,A,G 
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iOOO 21 34 12 1 

1003 3E 01 2 

1005 C3 00 10 3 

1008 C3 03 10 4 



FIRST LXI H,1234H 

SECOND MVI A,l 

JMP FIRST 

J MP SECOND 



THIS IS A SILLY PROGRAM 



Notice that the assembler allows us to fill out a line with comments. 
The listing shows the machine code at the addresses for which it is 
assembled, not where it is stored. We can check this: 

>#0DOOH. .ODOAH (The number sign # command is called DUMP on most systems.) 

ODOO 21 34 12 3E 01 C3 00 10 C3 03 10 

>#1000H..100AH 

0000 C3 5F ID 31 C4 OE CD 51 14 CD C3 

We can see that the assembled machine language was stored at ODOO, not 
at 1000 which still holds the beginning of ATE. 

There is another way to tell ATE where to begin the assembly 
or where to store the object code. (Note: object code = assembled 
machine language.) We can put instructions to this effect right in 
our assembly language program: 

Examp I e 6 



>t. 

>E( AORG lOOOH 

SORG ODOOH 
) 
>Z,A,G, 

000 1 

1000 ODOO 2 
1000 21 34 12 3 
1003 3E 01 4 
1005 C3 00 10 5 
1008 C3 03 10 6 



AORG 
SORG ODOOH 
FIRST LXI H,1234H 
SECOND MVI A,l 

JMP FIRST 
JMP SECOND 



THIS IS A SILLY PROGRAM 
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AORG (Assembly ORiGIn) tells ATE to assign the following value to the 

assembly program counter. SORG (Storage ORIGin) tells ATE to assign the 

following value to the storage pointer. These two assembly language 

instructions are called pseudo operations , since they are not actual CPU 

operations. 

Another pseudo-op, ORG, affects both & and $. (It is included 

mainly for compatabi I ity with other systems, which don't have AORG and 

SORG.) Using ORG 2000H in a program will increment & to 2000H, and then 

increment $ by the same amount (not necessarily to 2000H). That is, after 

the assembler sees ORG 2000H, then & = 2000H, and $ -$,.=& 

' new new old new 

& , . . One reason for this is to a I low you to use ORG to reserve 
old ' 

storage space in the middle of your machine language program. For 
instance, ORG &+I00 would reserve 100 bytes. 

An easier way to reserve memory space is to use the DS (Define 
Storage) pseudo-op. DS 100 wi I I reserve 100 bytes. DS, however, does 
not put any information into the reserved space. To do this, use DB 
(Define Byte), or DW (Define Word). 

Example 7 



>N,E( LHLD ADDRES 
ADDRES DW SECOND, 1234H 
DB 12H,34H,'A','B' 

) 

>&aDOOH,$,A,G, 

QDOO 2A 03 ID 1 

0D03 03 io 34 12 2 

0D07 12 34 41 42 3 



ADDRES DW SECOND, 1234H 

DB 12H,34H,'A','B' 



There are several things to notice in this example: 

(a) In the command line &OOOOH,$,A,G, we didn't give any argument after 

the $ command. As always, whenever a command argument is missing, ATE 

uses the argument from the last command. We could have typed &ODOOH,$O.DOOH, 

A,G, but that would have been redundant. 
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(b) We didn't Zero the symbol table before we gave the A command, so the 
symbols FIRST and SECOND (from the last example) are left In the table, 
along with their values of 1000 and 1003. So when the assembler sees DW 
SECOND, it assembles that correctly. 

(c) DW reverses the natural order of a two-byte word, as required by 
the 8080. 

(d) DB can be used to put ASCII characters into the program, as shown 
above, but an easier way is to use the ASC pseudo-op: 

Examp I e 8 

>N,E( ASC HELLO 
ASC- BY-BY 
) 

>G 

ODOB 48 45 4C 4C 4F 1 ASC HELLO 

ODIO 42 59 20 42 59 2 ASC- BY-BY 

Note that to insert a space (blank) character in the ASCII string, we 
signal that a dash (or any other non-alphanumeric character) will stand 
for a space by putting the dash right after the ASC. 

Example 9. Another important pseudo-op is EQU. 



>K. 








>E( LXI H,ADDRES 








ADDRES EQU 1234H 








),Z,A,G, 








0D15 21 34 12 


1 


LXI 


H, ADDRES 


1234 


2 


ADDRES EQU 


1234H 



Notice that In this example, we killed the contents of the current 
file and put new text Into it, rather than leaving the old file in 
memory and starting a new one as we did before. 
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The EQU pseudo-op puts the statement label (such as ADDRES above) Into 
the symbol table, and gives it the stated value. We can use the name ADDRES 
many times in the program, and if we ever want to change its value, we need 
only change the EQU statement. (However, we cannot change the value of 
ADDRES from one thing to another within the same program, i.e., we can have 
at most one EQU statement for each label.) 

Examp I e 10 . The last pseudo-op is END. 

>E( END 

THE REST OF THE FILE CAN HAVE ANYTHING IN IT. THE ASSEMBLER WILL NOT GO 

BEYOND AN "END" PSUEDO-OP. ) 

>". 

LXI H, ADDRES 
ADDRES EQU 1234H 

END 
THE REST OF THE FILE CAN HAVE ANYTHING IN IT. THE ASSEMBLER WILL NOT GO 
BEYOND AN "END" PSUEOD-OP. 
>Z,A,G 
0018 21 34 12 1 LXI H, ADDRES 

1234 2 ADDRES EQU 1234H 

CD IB 3 END 

Assembly language format rules : 

The assembly language program (or "source code") is a text file 
containing lines, or "statements". Each line looks like this: 

label opcode argument comment 

or 
* comment 

(1) Lines may not begin with a line number, as they must in some systems. 
However, a line number will be supplied with the program listing. 

(2) If the f I rst character (not the first non-blank character) is an *, 
then the rest of the line is taken to be a comment. 
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(3) The label is optional. If the line does begin with a label, then the 
first character in the line must be the first letter of the label. If 
the line has no label, then the first character must be a blank. The 
label must begin with a letter, and can contain only upper case letters 
and digits. 

(4) The opcode can be either a machine instruction or a pseudo-op. It 
must be preceded by a blank. 

(5) An argument is necessary for some opcodes. It must be preceded by 

a blank, and it cannot contain blanks except within quotes, such as MVI A,' ' 
Here, MVI is the opcode and A,' ' is the argument. 

(6) Anything after the argument is assumed to be a comment. 

(7) The number of blanks (as long as there is at least one) separating 
the label, opcode, argument, and comment have no effect on the format 
of the printout. This format may be changed by changing the tab stops 
(see Initialization Data). 

The assembler stops when it reaches an end-of-file marker or an END 
pseudo-op. (Any byte that is numerically less than a carriage return 
wi I I be treated as an end-of-f i le marker.) 



Assembly error messages: 

A Argument error. This can be caused by an undefined symbol (i.e., 

a name not in the symbol table, such as MADD in example 3) or by bad 

syntax. Arguments are generally not computed during pass 1, so 

this error message will be printed only during pass 2. Exception: 
arguments of pseudo-ops are computed during pass 1, and may cause 
this error message. 
M Missing label. This occurs only if you use an EQU pseudo-op 

without a label. This error message, along with the offending 

I ine, will be printed duri ng pass 1 and pass 2. 

D Doubly-defined label. The label is already in the symbol 

table, and you are attempting to change its value. The old 
value is retained. This can happen if you have just assembled 
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a program, and you are trying to re-assemble It without first zeroing 
the symbol table. Pass 1 and 2. 

L Label error — bad character In label. This can happen only If the 
first character in the line Is neither alphabetic, nor blank, nor 
*. (In particular, it can happen if the line begins with a number.) 
The assembler gives up on the offending line, and 3 NOPS (zero-bytes) 
are generated In place of whatever machine instruction was Intended. 
Pass 1 and 2. 

Opcode error. The opcode is not any recognizable operation or 

pseudo-operation. 3 NOPS (zero-bytes) are generated. Pass 1 and 2. 



The following summary of the ATE assembler contains some information 
not covered in this Introduction. 

ATE Assembler summary 

ATE contains an assembler based on the Processor Technology 
assembly language format. However, lines must not begin with a line 
number (although one will be supplied on the output listing). Old line 
numbers can be removed with a simple edit macro. Each line must begin 
with a label, if it has one, or else with a blank. Labels can be any 
length; the assembler will recognize all characters. But to keep the 
listing neat, labels should be ^ 6 characters. The label, opcode, 
argument, and comment must be separated by blanks, and the argument 
cannot contain blanks except within literals. 

All Instruction opcodes are standard. The pseudo-ops are: 

ORG Sets the assembly program counter (&) to the given value, and 

Increments the code storage pointer ($) by a like amount. 

& -& , .=$ -$ ... The ORG statement may be labeled, in 
new old new old ' 

which case the I able will have the new & as its value. 
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AORG "Address Origin." Sets & to the given value without changing $. 

If this statement is labeled, the label receives the new & value, 
SORG "Storage Origin." Sets $ to the given value without changing &. 

A label receives the current value of &, not $. 
DB "Define Byte." Standard, except that multiple bytes may be 

defined, separated by commas. 
DW "Define Word." Standard, except that multiple words may be 

defined, separated by commas. 
DS "Define storage." Standard. 
ASC "ASCII." Not standard. The ASCII string must be delimited by 

blanks (but may end with a carriage return). To embed blanks 

I n the ASCII stri ng: 

LABEL ASC- HELLO-WORLD- COMMENT 

Any non-alphanumeric character may be used in place of the -. 

Finally, the character t has a special significance within 

the ASCII string. It sets bit 7 of the preceding character. 

This is useful in constructing tables. See the section on 

The User Command Table for an example. 
EQU "Equals." Standard. May occur at most once for each label. 
END Standard. 

Assembly errors : A — Argument error. Zero Is used in place of the bad 

argument. Pass 2 only. 
M — Missing lable. Pass 1 and 2. 
D — Doubly-defined label. The old value of the label 

is retained. Pass 1 and 2. 
L — Label error, bad character. 3 NOPS (zeros) are 

generated. Pass 1 and 2. 
— Opcode error. 3 NOPS are generated. Pass 1 and 2. 



Assembly Commands 



Set the assembly program counter (which can be referenced by an 
& character in opcode arguments) to the given address. For 
example, & lOOOH. This command is superceded by an AORG or ORG 
statement in the source code. 
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Set the code storage pointer (which can be referenced by a $ 
character in opcode arguments) to the given address. For example, 
$ ODOOOH. This command is superceded by a SORG statement in the 
source code. 

"Assemble the symbol table." This performs pass 1 over the current 
file. The two passes of the assembler can be commanded separately 
in ATE. This allows you to treat many different files as one 
program. You can have a library of subroutines in source code 
on tape, for example, and incorporate selected ones into a new 
program by doing pass 1 over the desired files and then going back 
and doing pass 2 over the same f i les. The total amount of source 
code can be larger than memory, and there is no need to physically 
cocatenate all the files before assembling them. Of course, both 
passes can be commanded together by typing A,G. 

Note that A does not take an argument. The assembly program 
counter (&) and the code storage pointer ($) can be set before the 
first pass over the first file either by the & and $ commands above 
(e.g., &1000H,$ sets them both to lOOOH), or by AORG, SORG, or ORG 
statements in the source code. $ does not need to be set for pass 
1 unless it is referenced In the program. 

If an error is detected, an error code (l^,D,L, or for pass 
1) is printed, followed by the offending line. Otherwise, pass 1 
produces no listing. 

"Generate object code." This performs pass 2 over the current file, 
storing object code in memory and producing a full listing. If & 
and $ were set previously, they do not need to be reset for pass 2 — 
ATE does this automatically. The object code listing is produced 
in the current operating base (see the B command). 

Example: (This uses the tape commands J_dentlfy and J_oad, 
which will be covered later.) Suppose we have 11 consecutive source 
files on tape, which together would be too large to fit in memory. 
But we do have room to fit them in one at a time, and in addition 
we have room to store the 4K of object code they will produce. 



49 



(We could also put the code out onto tape — an example wi I I be 
given later.) We can assemble these files as one program by 
typing the following command lines: 

>&0, SODOOOH, Rll, I, L, A, K. . Then we rewind the tape and type 
>R11, 1, L, G, K. . We ki I I each file after we are 

through with it to make room 
for the next one. 
H "Hold the presses." This is the same as G except that it 

suppresses the listing of everything except the error lines. 
Note that even without a listing we can look at and edit the 
object code. Suppose that we want to look at the code for a 
routine called INIT, which ends just before a line labeled READ. 
We can type # INIT. .READ-1, since these symbols are now in the 
table. If we had assembled our code at one address and stored 
it at another, we could type 
F=$-&, # INIT+F..READ-1+F 

Z "Zero the symbol table." Initializes a new symbol table 

containing only the 8080 register symbols and their values. 
(A=7,B=0,C=1,D=2,E=3,H=4,L=5,M-6,SP=6,PSW=6). After initiali- 
zation, these symbols have no special status; they can be 
removed (using Zsymbol) or redefined (using = ) just like any 
other symbol. Note: if the table was Moved (as described under 
the Move command) then Zwill initialize the new table at the 
new address. 

Zsymbol Zero the given symbol. This removes the symbol from the 
table and compacts the table. For instance, Z INIT removes all 
traces of INIT (and Its value) from the table and compacts the 
table, freeing 6 bytes of table space. 

Z>symbol Zero after the given symbol. Removes all symbols from the 
table that were created chronologically after the given symbol. 
Before assembling a program, you can use this to remove conflicting 
symbols from the table (from a former assembly of the same 
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program, say) without destroying previously created variables that 
you want to save. There is usually no need to completely Zero the 
table. For instance, suppose you have saved some names for your 
often-used machine language routines (instead of putting these in 
the user command table). If the last such name to be saved was DOS, 
they typing Z>DOS before an assembly will preserve these names while 
giving you an otherwise clean slate. 



Tape Handling Commands 

These commands are fairly simple — they were designed with the 
realities of audio cassette recording in mind. But In combination 
with ATE's multi-command line and programming capability, they are 
quite powerful. See the examples at the end of this section. 

I "Identify." Identifies the next record on the tape (i.e., reads 
the record header) and prints information at the terminal. For 
example, if after loading ATE from cassette, you rewind the 
cassette to the lead-in tone; 
>I 

1000 IFFF ATE OBJECT CODE COPYRIGHT 4/15/77 G.FITTS 
This gives the addresses to which the record will load (unless you 
specify otherwise), and the record title. The tape is now stopped 
between the header and the record body, waiting for an L, J, or V 
command. 

Note: Every record on the tape consists of (a) a 5 second 
lead-in tone, (b) the record header — 256 bytes, approx. 9 seconds, 
(c) another 5 second tone, and (d) the record body. When a tape 
is first mounted, or after it is rewound, you must position it 
manually to the first lead-in tone. After this, ATE will automatically 
start and stop the tape at the correct positions with no further need 
for manual intervention. 

I(TITLE) Searches the tape (forward) for a record whose title begins 
with the given string. The entire title need not be given. For 



51 



example, KATE) would find the record mentioned above, as would 
KATE OBJECT), etc. Header info from other records encountered 
during the search Is printed, so Kany non-existent title) will 
catalog the tape. (The tape will run for about 1 minute beyond 
the end of recorded material before ATE will stop it, issue an 
error sign ?, and return control to the terminal.) 

Note: Control-A does not function while the tape Is 
running. But stopping the computer and restarting ATE at ad- 
dress SYSl will stop the tape. The tape must then be repositioned 
to a header lead-in tone. 

"Load." If used without an argument (there is no default 
argument in this case), the record is loaded at the address that 
was printed In response to the I command. If It is a source 
file, then this address is the top of the source area. In this 
case, the file is loaded, the source area is expanded to include 
the new f i le, and the new f i le becomes current with t at its end. 
(That Is, unless a checksum error occurs. See below.) 

If an address is given with the L command, then the file 
(source or not) Is simply loaded to that address. Even If it 
was a source file. It Is not made current or Incorporated into 
the source area. 

After loading, a checksum Is computed across the loaded 
record. An error will cause a ?, and control will return to 
the terminal. If the bad record was a source file, it wi i I not 
be incorporated into the source area or made current. 

Of course, multiple tape commands can be included In the 
command line or in a program, as for any ATE commands. 1,L 
will identify and load the next record. KBASIC), L,X<R> will 
find, load, and execute that record (as long as Its entry point 
is the first byte). Note than an I command must precede an L, 
although other non-tape commands can Intervene. 

"Jump over." Moves the tape past the previously Identified record 
and stops it. 
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"Verify." Checks the record byte-for-byte against memory, issuing 

a ? at the end if there is any difference. To use this command, 

first Save the record (see below), rewind the tape to the lead-in 

tone for the record body, and type V. (Or you can rewind to the 
header lead-in tone and type 1,V) 

"Save." Takes an argument, and saves the addressed interval on 
tape. For instance, S.. saves the current file, S<S> saves all 
files. SIOOOH. .IFFFH creates a new copy of ATE. 

(A) If no title was given (see the T command below), then a 
default title is used. For source files, this is the first 
line of the file. For object code, this is the first 8 bytes. 
(ATE labels a record "source" if it begins in the source area.) 

(B) If no wri te-address was given (see the W command below), then 
by default the wri te-address that Is saved with the record is 
the same as the address from which the record is saved. (This 
address can always be changed at load time. It is irrelevant 
for source files, which are always loaded onto the source area.) 

(C) Records saved with the S command (including ATE itself) can 
be loaded and executed by the ROM bootstrap loader on the 
Morrow interface board. Simply set the tape to the 'lead- in 
tone and execute the bootstrap (address 815FH=201:137Q) . 
The sense switches play the following role: 

If all switches are off, the program loads and executes 
(as long as there is no checksum error). If switch is on, 
the tape will stop after the record header has been loaded. 
You can then change the load address from the front panel. 
It is stored at address 8277H=202: 167Q, low byte first. Then 
turn switch off and restart the computer from where you 
stopped it. 

After the load is complete, a checksum is computed, and 
if in error, the computer enters a jump-self loop (C2 OC 82, 
or 302 014 202). Otherwise, switch 7 is checked. If off, 
the record is executed. If on, the computer loops, reading 
switch 7. At this point, you can go into the record from 
the front panel and change its 10, or whatever. 
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And one more feature: after changing the I/O or whatever, 
you can create an updated tape of the same record by setting 
your recorder to record and executing address 823EH=202:076Q. 
(Of course it would probably be easier to load ATE and use JJ^ 
to edit and save the new version of the record.) 
(D) George Morrow *s Speakeasy board can control up to three recorders 
ATE always reads from machine #1, and at first it also writes to 
machine #1. But editing a tape is ten times easier with two 
recorders. To make ATE write to recorder #2, type tOEF5H, 
E#85#. For further detai Is, see the sections entitled 
"Initialization" and "Initialization Values". 

T "Title." If used before the Save command (with no intervening tape 
commands), this titles the record about to be saved with the given 
text. The given text must be enclosed in parantheses. For example, 

T(ATE OBJECT CODE COPYRIGHT 4/15/77 G. FITTS), S 1000H..1FFFH 
will create the record mentioned under the { command. 

Note that there is really no need to title source code, since 
the default title (the first line) is the conventional title for 
the file once it is loaded into memory. 

W "Write address." If used before the Save command (with no interve- 
ning tape commands), this sets the write address (load address) of 
the record about to be saved to the given value. For instance, if 
you copied ATE to ODOOOH (say), and then installed some of your 
own custom patches, you could save the new version by typing: 
T( PERSONAL I ZED ATE), W lOOOH, S ODOOOH. .ODFFFH 

RS "Resave." If used after a load (with no intervening tape commands), 
this resaves the the record using the original title and load 
address. For instance, if you had just loaded ATE at ODOOOH, then 
typing RS would create a copy from this address that still had its 
original title and load address lOOOH 
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But if you typed S ODOOOH. .ODFFFH, then the load address of the 
new copy would be ODOOOH, and the title would be the first 8 bytes 
of code. 



Tape examp les 

Here is a command line to search the tape for a record containing STRING. 
R999, I, L, QS<R>/(STRING), K<R> 

Here is a program (called ^EDTAPE) to read through a tape, changing every 

occurrence of STRINGl to STRING2 and creating an updated tape. Note 

that ATE must write to recorder #2 (as described under Save) to make this 

feasible. 

*LOOP, QF(STRINGl), K, E(STRING2), X^LOOP) 

^EDTAPE, I, L, D(^LOOP), RS, K<R>, X^EDTAPE) 

If you want to assemble 10 files into a single program and you don't 
have enough memory to store the assembled object code, you could type 
the fol lowi ng I i nes: 

&0, RIO, SODOOOH, 1, L, A, K. . (Then rewind the tape) 

&0, RIO, $ODOOOH, I, L, W&, G, S ODOOOH.. $-1, K. . 



Gory detai Is 

Hardward Requirements 

To run ATE with no modifications, you need at least 8K of memory 
beginning at address and Morrow's 10 board connected to recorder #1 
and to a teletype (or other 110 baud serial device). More memory is 
desireable, as is a second recorder. 

If you meet all the above requirements except for the baud rate, 
then you can patch in the new rate by changing one byte. See below. 

If your terminal is not connected through Morrow's 10 board, you 
can patch your own 10 routines into ATE by changing three jump instructions 
The procedure is described below. 
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If your tape recorder is not connected through Morrow's board, 
then (assuming you can load ATE — see below) you can still use the 
editor and assembler parts of ATE, but you won't be able to use the 
tape commands, unless you patch in a new tape driver (see below). 

Load i ng ATE 

Assuming that you have the standard hardware described above, 
proceed as follows: mount the ATE cassette in recorder #1 and 
position the tape to the beginning of the first lead-in tone (about 
25 seconds into the tape). Then execute address 815FH = 201:137Q 
with all sense switches off . The ROM bootstrap loader on the 
Morrow 10 board will read in a loader from the tape, which will then 
load the ATE object code to addresses lOOOH. .IFFFH. This takes about 
2-3/4 minutes. Then, unless a checksum error is detected, ATE will 
begin executing, printing a prompt > character at the terminal. 
(If a checksum error is detected, the loader enters a jump-self 
loop: C2 OC 82 or 302 0X4 202). 

If you can load ATE as above, but you want to patch the baud 
rate or change the 10 before ATE starts executing, then turn sense 
switch 7 on_ before the load is complete. This will prevent the 
loader from passing control to ATE. When the tape stops, you can 
make the patches as described below and then execute ATE from 
address lOOOH. 

If you want to load ATE through some other cassette interface: 
ATE is recorded at 300 baud Kansas City Standard. The tape consists 
of (a) a 5 second lead-in tone, (b) a 256 byte header (approx. 9 
seconds), (c) a 1/2 second gap, (d) another 5 second lead-in tone, 
and (d) 4096 bytes of core image ATE object code, which should be 
loaded at address lOOOH. The 2 byte checksum for these 4096 bytes is 
stored in the header. It is the 43 and 44 bytes of the header, 
low byte f i rst. 
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Initicil ization 

ATE is written so that it can be stored in ROM. Consequently, you can 
write-protect the 2"^*^ 4K block of memory after loading ATE, if you want. 
ATE keeps its variables, stack, etc., in RAM beginning at address 0E60H = 
016:140Q, When ATE is executed from address lOOOH, initial values for many of 
these variables are copied into RAM. These initial values are stored 
together in a list within ATE. 

To make a permanent change in any of these values, you can make 
changes within this list. (See the addresses appendix for the details of 
this list.) To do this, you can load ATE with sense switch 7 on, make 
changes from the front panel, and then execute from address lOOOH. Or you can 
let ATE begin executing, make the changes using the Enter command, and then 
type XIOOOH. In either case, you will want to make an updated copy of 
ATE by typing T( PERSONAL I ZED ATE), S 1000H..1FFFH 

If you don't want your changes to be permanent, you can alter the 
desired data at its new location in RAM after initialization. (Again, 
see the addresses appendix for these locations.) 

10 Patching 

If you are using the serial port on the MMS 10 board and you simply 
want to patch in a new speed constant, enter it at one of the addresses 
given in the appendix (either the pre or post- initia I ization address, I BAUD or SCON, 
depending on whether you want a permanent or temporary change). 

Three routines are required for terminal 10: (a) a character 
input-echo routine, (b) a character output routine (which can be the 
echo part of the first routine), and (c) a panic detect routine. ATE 
accesses each routine through a single jump instruction, and a new 
routine can be patched in simply by changing the jump address. See the 
addresses appendix for the locations of these jumps. 

The requirements for these routines are as follows: In every 
case, the only CPU register that must be maintained is SP. You can 
use up to 20 bytes of stack, (a) The character input-echo routine 
should get a character from the terminal, strip off the parity bit if 
necessary, echo the character (possibly by falling into the character 
output routine), and return with the character in register A. (b) The 
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character output routine should output the character in register A. 
(c) The panic detect routine should RETurn to continue the current 
process, or jump to SYS1 to abort ft (see addresses appendix). 

Suggestions: 

The character output routine can drive a- different device than 
the echo routine. For instance, commands could be echoed to your 
CRT, while printouts (which come from the character output routine) 
could appear on your hardcopy device. 

Of course, ATE can change 10 devices under program control by 
entering a jump to the new driver at OTPAD (see appendix). For 
instance, suppose that your hardcopy driver is located at ODOOOH, 
while your CRT driver is at GEOGGH. You could create the following 
edit macros: 

^HARDCOPY, X=t, t OTPAD, E#C3 GG DG#, tX 
^SOFTCOPY, X=+, f OTPAD, E#C3 GG EG#, tX 

Now, D(^HARDCOPY) can be used in a command line or in a program to 
route output to the hardcopy device, while D(*SOFTCOPY) will return 
output to the CRT. (In each case, the entry pointer is saved and 
restored. ) 

ATE can be used with a half-duplex terminal by eliminating 
the echo part of the character input routine. 
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000 
000 
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000 
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000 
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000 
002 
004 
007 
011 
013 
014 
016 
020 
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024 
026 



000:027 
000:031 
000:033 
000:034 
000:036 
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000:044 
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000:000 
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000:200 
000:001 
020:003 
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333 
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000 
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000 
200 
014 

001 



000 



000 



333 000 

346 100 
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333 001 

315 000 000 

376 001 
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303 003 020 
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16 

17 

18 
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22 

23 
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26 

27 
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*SAMPLE 10 ROUTINES FOR THE 3P+S 

STATUS EQU STATUS PORT 

DATA EQU 1 DATA PORT 

DATAREADY EQU 4 0H 

PRINTERREADY EQU 80H 

ABORT EQU 1 CONTROL-A 

SYSl EQU 1003H ATE RE ENTRY POINT 



INECHO IN 

AN I 

JZ 

IN 

AN I 

OUTCHR MOV 

OUTLOP IN 

AN I 

JZ 

MOV 

OUT 

RET 
* 

PANDET IN 
AN I 
RZ 
IN 

CALL 
CPI 
RNZ 
JMP 



STATUS 

DATAREADY 

INECHO 

DATA 

7FH 

B,A 

STATUS 

PRINTERREADY 

OUTLOP 

A,B 

DATA 



STATUS 
DATAREADY 



DATA 

INECHO 

ABORT 

SYSl 





0000 




0001 




0040 




0080 




0001 




1003 


00^id 


DB 


6002 


E6 40 


00ili4 


CA 


0007 


DB 01 


0009 


£6 IF 


000B 


4 7 


0t30C 


DB 00 


000E 


E6 80 


0010 


CA 0C 


0013 


78 


0014 


D3 01 


0016 


C9 


0017 


DB 00 


0019 


E6 40 


001B 


C8 


001C 


Ob 01 


00lE 


CD 00 


0021 


BE 01 


0023 


C0 


0024 


C3 03 


> 





00 



00 



00 



10 



1 


* SAMPLE 10 : 


ROUTINES FOR THE 3P+S 


2 


STATUS 


EQU 


STATUS PORT 


3 


DATA 


EQU 


1 DATA PORT 


4 


DATAREADY EQU 40H 


5 


PKINTERKEADY EQU 80H 


6 


ABORT 


EQU 


1 CONTROL- A 


7 

8 

9 


SYSl 

is 


EQU 


1003tl ATE RE ENTRY 


INECHO 


I^^ 


STATUS 


10 




AN I 


DATAREADY 


11 




JZ 


I NEC BO 


12 




IN 


DATA 


13 




AN I 


7FH 


14 


OUTCHR 


iiOy 


B ,A 


15 


OUTLOP 


IN 


STATUS 


16 




AN I 


PRINTERREADY 


17 




J2 


OUTLOP 


i^S 




MOV 


A,B 


'l9 




GUT 


DATA 


20 




RET 




21 


* 






22 


PANDET 


IN 


STATUS 


23 




AiSil 


DATAREADY 


24 




RZ 




25 




IN 


DATA 


26 




CALL 


INECHO 


27 




CPI 


ABORT 


28 




RNZ 




29 




J MP 


SYSl 



POINT 
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The Tape Driver 

If you don't have George Morrow's Interface board,, you will have 
to duplicate some of its onboard ROM software with your own tape 
driver, and you will have to provide 512 bytes of memory at 8200H = 
202:000Q. (This data buffer cannot be relocated without reassembling 
ATE, since ATE contains code that executes within this address space.) 
ATE accesses its tape driver thru a single call instruction at 
TAPCAL (see appendix and (5) below), and uses these conventions: 

(1) If bit of the A register is 1, then a write operation is 
requi red: 

(a) The HL register pair contains the beginning address of 
the data to be written. 

(b) The DE register pair contains the number of bytes to be 
written. 

(2) If bit of the A register is 0, then a read operation is 
req u i red : 

(a) The HL register pair contains the beginning address of 
the buffer where the data should be stored. 

(b) The DE register pair contains the number of bytes to 
be read and stored. 

(c) If the C register equals 0, then the data should simply 
be read and stored. However, if the C register equals 
1, the data should be read but not stored (i.e., the 
tape should be advanced over DE bytes). If the C 
register equals 40H, then the data should be read and 
compared to memory beginning at address HL. If a 
discrepancy is found, a non-zero byte should be stored 
at address DERR (see appendix). (In addition, you could 
store the address of the offending byte at ERSAV. Then 
one of the commands "?, #?, or ?? would give information 
about this address). 

(3) If your tape interface is capable of detecting any physical 
error conditions in your tape hardware, you can signal this 
to ATE by storing a non-zero byte at SERR and returning. 
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(This Is what allows ATE to signal an error after one minute of 
listening to a blank or motionless tape.) 

(4) If your tape interface has motion control , it should stop the tape 
after each read or write operation. 

(5) You will also have to provide a checksum computing routine. ATE uses 
the routine CHECK on Morrow*s I/O board, calling this routine twice 
at CHECK1 and CHECK2 (see appendix). If you want, you can duplicate 
the code for CHECK, which follows. In any case, you will have to use 
the same conventions. 

(6) Finally, if you want the bootstrapping capabi I ity and the reproduc- 
tive capability provided by each ATE record header, you will have to 
keep your tape driver and checksum computer in ROM, and you will have 
to provide a bootstrap loader in ROM that can read the 256 byte header 
into TAPRAM and then branch there. 



COMPUTE CHECK-SUM ROUTINE 



Calling conventions: 

(A) The register pair H-L is loaded with the starting address of 
the data block on which the check-sum is to be computed. 

(B) The register pair D-E is loaded with the word count of the 
data block. 

(C) The computed check is returned in the register pair H-L. 



Inclu 


ding the i 


"eturn address 


of the 


calling program, the routine uses 


four 


1 eve 1 s 


of 


the stack. 






814D 


E5 




CHECK 


PUSH 


H 


SAVE ADDRESS POINTER 


SHE 


21 00 


00 




LXI 


H,0 


INITIALIZE CHECK SUM 


8151 


44 






MOV 


B,H 




8152 


E3 




GDATA 


XTHL 




SAVE AND EXCHANGE/ADDR POINTER 


8153 


4E 






MOV 


C,M 


GET DATA 


8154 


23 






INX 


H 


INCREMENT ADDRESS POINTER 


8155 


E3 






XTHL 




SAVE & GET PARTIAL CHECK SUM 


8156 


09 






DAD 


B 


ADD NEW DATA 


8157 


IB 






DCX 


D 


DECREMENT WORD COUNT 


8158 


7A 






MOV 


A,D 


TEST FOR 


8159 


B3 






ORA 


E 


WORD COUNT 


815A 


C2 52 


81 




JNZ 


GDATA 


EQUAL ZERO 


815D 


Dl 






POP 


D 


RESTORE STACK 


815E 


C9 






RET 
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The user command table 

The user command table is Initially located at lUSRCT (see 
appendix), but this may be changed at any time (see below). 
Command names may be any length, and may contain any printing 
ASCII characters. The only restrictions are: 

(a) The last byte of each command name in the table must 
have its high order bit set to 1. (Since the ASCII 
code only requires the low order 7 bits, this does not 
restrict your choice of characters.) 

(b) The command name must be fol lowed by the command 
address, low byte first. 

(c) The table must end with a zero byte. 

You can create a user command table with the Enter command, 
but the easiest way is to assemble it in place, as in the example 
on the next page. Once you have created a table, you can save it 
on tape (along with the object code for Its routines), and re- 
load it at any time. See the Save command. 

When ATE is initialized, it writes a zero (= end-of-table 
byte) at lUSRCT, and writes the address lUSRCT into RAM at USRCT. 
Thereafter, whenever ATE is given a command, it begins searching 
at USRCT first before searching its own Internal command tables. 
Thus user commands can supercede ATE's. For instance, if you 
create a command called PUNCH, ATE will not interpret this as 
Print UNCH. 

The user command table can be relocated in several ways. 
You can always change lUSRCT before Initialization, or change 
USRCT after initialization. If you already have a table occupying 
addresses OEOOH. .OEOCH, for instance, and you want to move it to 
3000H, simply type t3000H, M OEOOH. .OEOCH . ATE will realize 
that you have moved the user command table, and will remember the 
new location. 
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> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

>N,E( 
SQRG 
ASC 
Dvi 
ASC 
DW 
DB 

> 

>G 

016:0 

016:0 



AORG 0E00H 

0e0 0h start of user commaij^d table 

pnch" 

D0 00H ADDRESS OF tbiCti 
PAPR" 

E0 00H ADDRESS OF PAPR 
EKD OF TABLE) 



00 

00 016:000 



016: 

016: 

016: 

016: 

016: 

> 

> 

>B16 

0E00 

0E00 

0E00 

0E04 

0E06 

0E0A 

0E0C 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 



000 
004 

006 
012 
014 



,G 



120 
000 
120 
000 
000 



116 
320 
101 
340 



1 

2 

103 310 3 



120 322 



0E00 



50 
00 
50 

00 

00 



4E 

D0 
41 
E0 



43 C8 



50 02 



AORG 


0E00H 


SORG 


0E00H 


ASC 


PtKH" 


DVM 


0D000a 


ASC 


PAPR'^ 


DW 


0E000H 


DB 






START OF USER COMMAND 
TABLE 

ADDRESS OF PNCH 

ADDRESS OF PAPR 
END OF TABLE 



AORG 


0E00H 


SORG 


0E0idti 


ASC 


PNCH'^ 


DVi 


0D000h 


ASC 


PAPR'* 


DW 


0E000H 


DB 






START OF USER COMMAND 
TABLE 

ADDRESS OF PNCH 

ADDRESS OF PAPR 
BUD OF TABLE 
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ATE addresses — functional descriptions (numerical values follow) 

IBOSA Pointer to initial beginning of source file area 

ICODE Initial value of & and $ 

IBAUD Initial speed constant for Morrow's interface board 

iSYMTB Pointer to initial beginning of symbol table 

IBASE Initial base for numerical input and output 

IWCHNL Initial write channel — ie, reg A constant for WRITE 

calls to COPE (the ROM tape driver on Morrow's 10 board). 

83H = 203Q for recorder #\ , 85H = 205Q for recorder #2, 

or 89H = 21 IQ for recorder #3. 
lUSRCT Pointer to the beginning of the initial user command table. 

(ATE writes a zero there during initialization.) 
UNPAD Contains a jump to the initial character input-echo routine, 
lOTPAD Contains a jump to the initial character output routine. 
IPNPAD Contains a jump to the initial panic-detect routine. 
I WIDTH Initial terminal width 
ITAB1 Initial TAB1; column number for labels 
ITAB2 Initial TAB2; column number for opcodes 
ITAB3 Initial TAB3; column number for arguments 
ITAB4 Initial TAB4; column number for comments 
lALOFF Initial assembly source- I i sting offset; column number for 

error flag (if any). The source listing follows to the 

right of this column, with TABS 1-4 interpreted relative 

to this column. 

BASE Current base for numerical input and output. 

WCHNL Current write channel (see IWCHNL above) 

USRCT Pointer to the beginning of the current user command table 

INPAD Contains a jump to the current input-echo routine. 

OTPAD Contains a jump to the current character output routine. 

PNPAD Contains a jump to the current panic-detect routine. 
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WIDTH Current terminal width 

TAB1 Current tab 1; column number for labels 

TAB2 Current tab 2; column number for opcodes 

TAB3 Current tab 3; column number for arguments 

TAB4 Current tab 4; column number for comments 

ALOFF Current assembly source-l isting offset. The source code 

is listed to the right of the object code, with tabs 1-4 

interpreted relative to this offset. 

ATERAM The beginning address for storage of ATE's variables and stack 

BOSAP Pointer to the beginning of the current source file area 

EOSAP Pointer to the end of the current source file area 

BOFP Pointer to the beginning of the current file 

EOFP Pointer to the end of the current file 

ASPC Assembly program counter (&) 

STCTR Assembly storage pointer ($) 

SYMTB Pointer to the beginning of the current symbol table 

TABA Pointer to the end of the current symbol table 

CHPTR The entry pointer (f) 

PNTR The command interpretation pointer 

PI The beginning value of the argument (<) 

P2 The ending value of the argument (>) 

RE CAD Pointer to the beginning of the record read in from tape 

RECND Pointer to the end ot the record read in from tape 

ERSAV Pointer to the character that caused a command interpretation 

error (?) 

PHD The column in which the print head is waiting 



SYSO 



SYSl 



This is the beginning of ATE, ie, the entry point that 

initializes everything. Jump here after power up. Typing 

X followed by this address will re-initialize ATE. 

This is the re-entry point to ATE that avoids re-initialization 
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VCHK This is useful with user-written machine language routines 
called from ATE (via the user command table, or via an X 
command). VCHK will return with the Z flag off if there ±s_ 
an argument following the command, or with the Z flag on 
if there is no argument. (See the X command for more info.) 

CVALS This routine returns the values of any ATE argument that 
follows a user command. The beginning value is returned 
in HL, while the ending value is returned in DE. If there 
is no argument, the values computed for the last command 
are returned. Any error encountered wi I I cause a ?-output 
and will return control to the terminal. If the user has 
supplied several arguments (separated by blanks), these 
can be detected by VCHK and evaluated by repeated calls 
to CVALS. CVALS will not proceed beyond a comma, carriage 
return, or end-of~file zero byte. The reference string for 
any matching operands is the current f i le. 

VALUS This routine is the same as CVALS with two exceptions: 

you must provide the beginning and ending addresses of any 
reference string in HL and DE; and in case of an error, 
VALUS simply returns with the Z flag off. 



LISTR 



MARGN 



A terminal width of less than approximately 50 (depending 
on your tab settings) will not accomodate an assembly 
listing properly. To remedy this, replace the CALL TAB 
at LISTR with a CALL MARGN. 



CHECKl If you don't have Morrow's 10 board and you are supplying 
CHECK2 your own tape driver, you will also have to supply a 

checksum computing routine as described earlier in the 
TAPE DRIVER section. Replace the CALL CHECK at CHECKl and 
CHECK2 with a call to your own checksum routine. 
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TAPCAL This Is AtE's only call to its tape driver, so you can 

patch in your own driver by changing this call. See also 
CHECK1 and CHECK2 above and the "tape driver" section of 
the manual . 



TAPRAM 

SCON 
DERR 
SERR 



CHKSM 

LODAD 

LNGTH 

TYPE 

WUNIT 



TITYP 
TITLE 



Each I command, and each bootstrap load, reads a 256 byte 
record header into this location. 

Speed constant for the serial interface on Morrow's 10 board 
DATA ERROR and STATUS ERROR. Before each tape driver call, 
ATE sets these bytes to zero. On return from the tape 
driver, ATE checks both bytes, and if either one is non- 
zero, ATE signals an error and returns control to the 
terminal. See the "tape driver" section for more info. 
Note that ATE's checksum logic is independent of these 
bytes. 

The record checksum 
The record load-address 
The record length 

The record type: an ASCII *S' for source, 'B' for binary 
The recorder (see WCHNL) that will be used if the 
reproductive capability of the record header is invoked. 
See the Save command for more info. 
The type of the record title. See TYPE above. 
The title that was given at Save time, if any, or else 
the first 128 bytes of the record. 
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ATE memory map : standard initialization, minimal 8K system 



200H 



400H 



OEOOH 



0E60H 



lOOOH 



2000H 



8000H 



8200H 



8400H 



object 

code 

area 

512 bytes 



symbol 

table 

area 

512 bytes 



source 
fi le 
area 
2560 bytes 



user 
command 
table 
96 bytes 



ATE 
RAM 
416 bytes 



ATE 
ROM 
4K bytes 



002:000Q 



004:000Q 



016:000Q 



016:140Q 



020:000Q 



Tape 




ROM 




512 


bytes 


Tape 




RAM 




512 


bytes 



040:000Q 



200:000Q 



202:000Q 



204:000Q 



These addresses can 
be changed from the 
terminal at any time, 



These addresses can 
be changed only by 
reassembi ing ATE. 



69 



035:224 


000 


004 




035:226 


000 


000 




035:230 


254 


000 




035:232 


000 


002 




035:234 


010 






035:235 


203 






035:236 


000 


016 




035:240 


303 


345 


027 


035:243 


303 


263 


201 


035:246 


303 


202 


027 


035:251 


110 






035:252 


010 






035:253 


017 






035:254 


024 






035:255 


035 






035:256 


025 







016 
016 
016 
016 
016 
016 
017 
017 
017 
017 
017 
017 



364 
365 
366 
370 
373 
376 
001 
002 

003 

004 
005 
006 



000 
000 
000 
000 
000 
000 
000 
000 

000 
000 

000 
01^0 



001 
001 
002 
003 
003 
003 
001 
001 
001 
001 
001 
001 



016: 


!l40 


001: 


'240 


016: 


'322 


000: 


'002 


016: 


'326 


000 : 


:002 


016: 


:332 


000. 


:002 


016: 


:336 


000; 


:002 


016: 


320 


000; 


:002 


016: 


.324 


000: 


:002 


016: 


:362 


000: 


:002 


016; 


:356 


0^0 


:002 


016: 


:342 


00id 


:002 


016- 


:306 


000 


:002 


016. 


:312 


0i6i0 


:002 


016: 


:316 


000; 


:002 


016: 


'346 


000; 


'002 


016: 


:352 


000. 


:002 



1 


*ATE ADDRESSES ~ NUMERICAL VALUE 


2 


* 








3 


* 








4 


*THE FOLLOWING ARE 


COPIED INTO RA 


5 


*AT INITIALIZATION 


TIME 


6 


* 








7 


IBOSA 


Dvy; 


400H 




8 


I CODE 


DW 







9 


I BAUD 


DW 


0ACH 




10 


ISYMTB 


DW 


20 0H 




11 


IBASE 


DB 


8 




12 


IwCHNL 


DB 


8 3H 




13 


lUSRCT 


DW 


0E00H 




14 


UNPAD 


J MP 


MINPT 




15 


lOTPAD 


JMP 


SROUT 




16 


IPNPAD 


J MP 


PANIC 




17 


IWIDTH 


DB 


72 




18 


ITABl 


DB 


8 




19 


I TAB 2 


DB 


15 




20 


I TAB 3 


DB 


20 




21 


ITAB4 


DB 


29 




22 


lALOFF 


DB 


21 




23 


* 








24 


^STARTING VvITB IBASE, THE ABOVE 


25 


*VALUES ARE 


COPIED 


INTO THE 


26 


*FOLLOWING 


RAM LOCATIONS 


27 


* 








28 


BASE 


DS 


1 




29 


/(iCHNL 


DS 


1 




30 


USRCT 


DS 


2 




31 


IN PAD 


DS 


3 




32 


OTPAD 


DS 


3 




33 


PNPAD 


DS 


3 




34 


k^IDTH 


DS 


1 




35 


TABl 


DS 


1 




36 


TAB2 


DS 


1 




37 


TAB 3 


DS 


1 




38 


TAB4 


DS 


1 




39 


ALOFF 


DS 


1 




40 


* 








41 


*OTH£R 


LOCATIONS IN ATE RAM 


42 


* 








43 


ATE RAM 


DS 


200+BUFLN+BUFLN+BUFLN 


44 


BOSAP 


DS 


2 




45 


EOSAP 


DS 


2 




46 


EOFP 


DS 


2 




47 


EOFP 


DS 


2 




48 


ASPC 


DS 


2 




49 


3TCTR 


DS 


2 




50 


SYWTB 


DS 


2 




51 


TASA 


DS 


2 




52 


CHPTR 


DS 


2 




53 


PNTR 


DS 


2 




54 


PI 


DS 


2 




55 


P2 


DS 


2 




56 


RECAD 


DS 


2 




57 


REClvID 


DS 


2 





70 



016:354 


0-00:002 




58 


ERSAV 


OS 


2 


017:032 


000:002 




59 

60 


PHD 

* 


DS 


2 








61 


*ADDRESSES ! 


INSIDE ATE 








62 


* 






020:000 


303 137 


035 


63 


SYS0 


JMP 


I NIT 


020:003 


061 304 


016 


64 


SYSl 


LXI 


SP, STACK 


021:014 


315 005 


030 


65 


VCHK 


CALL 


SBLK 


021:025 


315 067 


021 


66 


CVALS 


CALL 


FVALS 


021:103 


257 




67 


VALUS 


XRA 


A 


033:075 


315 222 


031 


68 


LISTR 


CALL 


TAB 


027:260 


257 




69 


MARGN 


XRA 


A 


034:061 


315 115 


201 


70 


CHECKl 


CALL 


CHECK 


034:122 


315 115 


201 


71 


CHECK2 


CALL 


CHECK 


034:164 


315 012 


201 


72 
73 


TAPCAL 


CALL 


COPE 








74 


*ADDRESSES : 


IN THE TAPE RA, 








75 


* 






202:000 


002:000 




76 


TAP RAM 


DS 


512 


203:363 


000:002 




77 


SCON 


DS 


2 


203:365 


000:001 




78 


DERR 


DS 


1 


203:366 


000:001 




79 
80 


SERR 
* 


DS 


1 








81 


*THE FOLLOWING ARE LOADED 








82 


*WITH J 


EACH ; 


RECORD HEADER 








83 


* 






202:052 


000:002 




84 


CHKSM 


DS 


2 


202:167 


000:002 




85 


LODAD 


DS 


2 


202:171 


000:002 




86 


LNGTH 


DS 


2 


202:173 


000:001 




87 


TYPE 


DS 


1 


202:174 


000:001 




88 


v^UMIT 


DS 


1 


202:175 


000:001 




89 


TITYP 


DS 


1 


202:176 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 


000:202 




90 


TITLE 


DS 


TAPRAM+256-& 
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1D94 


00 


04 




1D96 


00 


00 




1D98 


AC 


00 




1D9A 


00 


02 




1D9C 


08 






1D9D 


83 






1D9E 


00 


0E 




1DA0 


C3 


E5 


17 


1DA3 


C3 


B3 


81 


1DA6 


C3 


82 


17 


1DA9 


48 






IDAA 


08 






IDAB 


0F 






IDAC 


14 






IDAD 


ID 






1DA£ 


15 







0Ef4 


0001 


0Ef5 


0001 


0EF6 


0002 


0EF8 


0003 


0EFB 


0003 


0EFE 


0003 


0F01 


0001 


0F02 


0001 


0F03 


0001 


0F04 


0001 


0F05 


0001 


0F06 


0001 



0E60 


01A0 


0ED2 


0002 


0ED6 


0002 


0EDA 


0002 


0EDE 


0k)02 


0ED0 


0002 


0ED4 


0002 


0EF2 


0002 


0EEE 


0002 


0EE2 


0002 


0EC6 


0002 


0ECA 


0002 


0ECE 


0002 


0EE6 


0002 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

4^ 

41 

42 

43 

44 

45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 



*ATE ADDRESSES — NUMERICAL VALUES 
* 

*TflE FOLLOWIiSlG ARE COPIED INTO RAH 
*AT INITIALIZATION TIME 

IBOSA Dh 4 00H 

ICODE Dw 

I BAUD DW 0ACH 

ISYMTB DW 200H 

IBASE DB 8 

IWCHiNL DB 83H 

lUSRCT Dw 0E00H 

UNPAD JMP MI^iPT 

IOTP AD J MP SROUT 

IPNPAD JMP PAMIC 

iVvIDTH DB 72 

ITABl DB 8 

ITAB2 DB 15 

ITAB3 DB 20 

1TAB4 DB 29 

lALOFF DB 21 
* 

*STARTING WITH IBASE, THE ABOVE 
*VALUES ARE COPIED INTO THE 
*FOLLOWING RAM LOCATIONS 

■k 



BASE 

^^CHNL 

USRCT 

INPAD 

OTPAD 

PNPAD 

WIDTH 

TA31 

TAB 2 

TAB 3 

TAB 4 

ALOFF 



DS 
DS 

DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 



*OTHER LOCATIONS IN ATE RAM 



ATE RAM DS 

BOSAP DS 

EOSAP 

BOFP 

EOFP 

ASPC 

STCTR 

SYhTB 

TABA 

CHPTR 

PiMTR 

PI 

P2 

RECAD 



DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 
DS 



200+BUFLN+BUFLN+BUFLN 

2 

2 

2 

2 

2 

2 

2 

2 

2 

2 

2 

2 

2 
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0EEA 


0002 


0EEC 


0002 


0F1A 


0002 



1000 


C3 


5F 


ID 


1003 


31 


C4 


0E 


110C 


CD 


05 


18 


1115 


CD 


37 


11 


1143 


AF 






1B3D 


CD 


92 


19 


17B0 


AF 






1C31 


CD 


4D 


81 


1C52 


CD 


4D 


81 


1C74 


CD 


0A 


81 



8200 
83F3 
83F5 
83F6 



822A 

8277 

8279 

827B 

827C 

827D 

827E 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 

> 



0200 
0002 
0001 
0001 



0002 
0002 
0002 
0001 
0001 
0001 
0082 



57 


KECnD 


DS 2 


58 


ERSAV 


\jS 2 


59 


PHD 


DS 2 


60 


* 




61 


*ADDRESSES INSIDE ATE 


62 


* 




63 


SYS0 


JMP It\iIT 


64 


SYSl 


LXI SP, STACK 


65 


VCHK 


CALL SBLK 


66 


CVALS 


CALL FVALS 


67 


VALUS 


XRA A 


68 


LISTR 


CALL TAB 


69 


i^iARGlsi 


XRA A 


70 


CHECKl 


CALL CHECK 


71 


CHECK2 


CALL CHECK 


72 


TAPCAL 


CALL COPE 


73 


* 




74 


♦ADDRESSES IN THE TAPE RAM 


75 


* 




76 


TAPRAM 


DS 512 


77 


SCON 


DS 2 


78 


DERR 


DS 1 


79 


SERR 


DS 1 


80 


* 




81 


*THE FOLLOWING ARE LOADED 


82 


*vvITH ] 


EACH RECORD HEADER 


83 


* 




84 


CBKSM 


DS 2 


85 


LODAD 


DS 2 


86 


Lt^GTH 


DS 2 


87 


TYPE 


DS 1 


88 


WDNIT 


DS 1 


89 


TITYP 


DS 1 


90 


TITLE 


DS TAPRAM+256-& 
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Bugs 



#FF#@ doesn't work properly as a command argument. Using the any- 
character matching operand @ cocatenated with numerically 
expressed bytes will conflict with an FF byte, if there Is 
one within the # signs. (It will cause the FF byte to match 
anything.) Rule: don't use FF and @ together. 

OPCODE COMMENT does not print properly when the opcode requires no 
argument. The print routine does not know which opcodes 
require arguments and which don't, so in this case the comment 
will be printed in the argument field. Rule: if you want to 
comment a line where the opcode doesn't require an argument, 
use some visually inoffensive character (such as a period) 
as the 'argument'. This won't affect the assembly, and the 
line will list correctly. 

ASC TOO-MANY-CHARACTERS will assemble correctly but will not list 
correctly. Instead of keeping the object code in its proper 
columns, the listing will allow the object code to run over 
into the source code columns, displacing the source listing 
of that line to the right. Rule: to keep a hex assembly 
listing neat, use 5, or fewer ASC characters per line. For 
an octal listing, use 4 or fewer. Or, more characters can 
be accomodated per line by Increasing ALOFF (see appendix). 

DB too many bytes, and DW too many words: same comments as for 
ASC above. 



Takes an argument? Reference string See page 

Basic editing 

t Set the pointer yes current file 19 

E Enter no 20 

K KIM yes current file 22 

M Move yes current file 22 

C Copy yes current file 23 

Printing 

" Quote yes current file 24 

* Quote one 1 1 ne no 24 

P Print yes current file 24 

B Base yes (current file) 25 

* Quote numbers yes current file 25 

? Where yes current file 26 

Memory f I les 

F File yes source area 27 

N New no 27 

Originate yes current file 28 

Programming 

D Do yes source area 28 

> Goto yes source area 29 

R Repeat yes ....(current file) 30 

* Label no 30 

QF Quit on failure yes current file 31 

QS Quit on success yes current file 32 

= Equals yes current file 32 

X Execute yes (current file) 32 

AssembI Ing 

& Set & yes current file 47 

$ Set $ yes current file 48 

A Assemble the table .. no 48 

G Generate object code no 48 

H Hold the presses .... no 49 

Z Zero the table no 49 

Ziabet Zero the label .. no 49 

Z label Zero after no 49 

Tape hand I Ing 

I Identify no 50 

KTItle) no 50 

L Load optional current file 51 

J Jump over no 51 

V Verify no 52 

S Save yes current file 52 

T Title no 53 

W Write address yes current file 53 

RS Resave no 53 



